Google Git
Sign in
chromium / chromiumos / docs / refs/heads/stabilize-12371.80.B
commit0dcfa196870a38826d0f17f136434581f92107fa[log] [tgz]
authorYu Zhao <yuzhao@google.com>Wed Jul 17 21:38:56 2019
committerchrome-bot <chrome-bot@chromium.org>Tue Jul 23 22:40:30 2019
tree7c6e24c2eeaf8d53b5e269e367becf2c6b23d45b
parent513e437753cd47c34ae391d8b7aa198f6f1ca6f0 [diff]
kernel_faq: recommend USE="debug" for testing build

USE="debug" turns on debugging options like lockdep and KASAN.

Change-Id: I8faeaa27f8515fcb0842171487f0fd27c2bf3daf
Signed-off-by: Yu Zhao <yuzhao@google.com>
Reviewed-on: https://chromium-review.googlesource.com/1707379
Tested-by: Yu Zhao <yuzhao@chromium.org>
Commit-Ready: Yu Zhao <yuzhao@chromium.org>
Legacy-Commit-Queue: Commit Bot <commit-bot@chromium.org>
Reviewed-by: Justin TerAvest <teravest@chromium.org>
Reviewed-by: Yu Zhao <yuzhao@chromium.org>
1 file changed
tree: 7c6e24c2eeaf8d53b5e269e367becf2c6b23d45b
  1. constants/
  2. design_docs/
  3. images/
  4. packages/
  5. portage/
  6. scripts/
  7. security/
  8. testing/
  9. .gitignore
  10. archive_mirrors.md
  11. ca_certs.md
  12. chrome_commit_pipeline.md
  13. COMMIT-QUEUE.ini
  14. contact.md
  15. containers_and_vms.md
  16. contributing.md
  17. cros_commit_pipeline.md
  18. cros_flash.md
  19. cros_vm.md
  20. dbus_best_practices.md
  21. dbus_in_chrome.md
  22. debug_buttons.md
  23. developer_guide.md
  24. development_basics.md
  25. eol_aue_process.md
  26. fuzzing.md
  27. glossary.md
  28. gsutil.md
  29. kernel_faq.md
  30. lsb-release.md
  31. navbar.md
  32. os_config.md
  33. OWNERS
  34. platform2_gn.md
  35. platform2_primer.md
  36. PRESUBMIT.cfg
  37. README.md
  38. reporting_bugs.md
  39. rust_on_cros.md
  40. sandboxing.md
  41. security_review_howto.md
  42. security_severity_guidelines.md
  43. security_sheriffing.md
  44. selinux.md
  45. simple_chrome_workflow.md
  46. source_layout.md
README.md

Chromium OS docs

This directory contains public Chromium OS project documentation that is automatically rendered by Gitiles. The docs are written in Gitiles-flavored Markdown.

General guidelines

See the Chromium documentation guidelines and Chromium documentation best practices.

Style guide

Markdown documents must follow the style guide.

Making changes

This repository is managed by the repo tool, so you can make changes to it using the same techniques that you'd use for any other repositories in the project.

See the Contributing guide for more details.

Making changes without repo

You can also make changes to this repository without using the repo tool. This comes in handy when you don't have a Chromium OS checkout:

git clone https://chromium.googlesource.com/chromiumos/docs
curl -Lo .git/hooks/commit-msg https://gerrit-review.googlesource.com/tools/hooks/commit-msg
chmod +x .git/hooks/commit-msg
cd docs
git checkout -b changes
(make some changes)
git commit -a
git push origin HEAD:refs/for/master

The above steps will upload a patch to chromium-review.googlesource.com where you can get your patch reviewed, and submit.

Previewing changes

You can preview your local changes using scripts/preview_docs which utilizes Gerrit sandbox branches:

scripts/preview_docs README.md

You can also use md_browser, which is entirely local and does not require refs/sandbox/ push permission, but has somewhat inaccurate rendering:

# at top of Chromium OS checkout
./src/chromium/src/tools/md_browser/md_browser.py -d docs

Then browse to e.g. http://localhost:8080/README.md.

To review someone else's changes, apply them locally first, or just click the gitiles link near the top of a Gerrit file diff page.