Files

Chris Palmer 746a8e1cd7 More OWNERS for docs/security.

BUG=NONE

Change-Id: I6976ea94e9fb6fef2a300d3c70209dc36e289e0a
Reviewed-on: https://chromium-review.googlesource.com/594887
Reviewed-by: Chris Palmer <palmer@chromium.org>
Reviewed-by: Varun Khaneja <vakh@chromium.org>
Commit-Queue: Chris Palmer <palmer@chromium.org>
Cr-Commit-Position: refs/heads/master@{#490797}

2017-07-31 21:01:14 +00:00

accessibility

Rename AXObject to AXObjectImpl in modules/ and web/

2017-05-17 07:31:46 +00:00

design

Correct threading documentation example.

2017-06-23 23:15:27 +00:00

images

…

ios

Add passing test arguments to docs/ios/build_instructions.md

2017-07-18 11:13:16 +00:00

media

[Blink>Media] Moving autoplay logic to AutoplayPolicy

2017-04-20 21:24:05 +00:00

memory

docs: fix broken links in /docs/memory

2017-06-26 16:18:15 +00:00

memory-infra

Fix links to memory-infra README and add a note about reading traces.

2017-07-06 17:39:04 +00:00

process

Add uncertainty section to release blockers doc.

2017-07-24 21:28:51 +00:00

security

More OWNERS for docs/security.

2017-07-31 21:01:14 +00:00

speed

Add static initializer regressions to apk_size_regressions.md

2017-07-28 13:09:06 +00:00

sync

[Sync] Adding missing DependsOn to *ProfileSyncServiceFactory.

2017-03-28 16:52:20 +00:00

testing

Update layout test rebaselining documentation

2017-07-25 17:22:17 +00:00

ui/views

Cocoa coordinates start at the bottom left; content ➞ contents to be consistent with Views code.

2017-05-22 16:24:56 +00:00

accessibility.md

Added docs on accessibility tests

2017-03-02 06:58:46 +00:00

adding_to_third_party.md

[about:credits] Make webview use chrome license file

2017-07-14 17:01:46 +00:00

android_accessing_cpp_enums_in_java.md

Cleanup definition of ActivityState and ApplicationStatus warnings

2017-05-12 20:33:39 +00:00

android_build_instructions.md

Android: Update docs to use generated apk wrapper scripts

2017-07-26 18:02:13 +00:00

android_cast_build_instructions.md

Android: Update docs to use generated apk wrapper scripts

2017-07-26 18:02:13 +00:00

android_debugging_instructions.md

Android: Update docs to use generated apk wrapper scripts

2017-07-26 18:02:13 +00:00

android_logging.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

android_studio.md

Update android studio doc about formatting commits.

2017-05-10 16:05:03 +00:00

android_test_instructions.md

Update android test instructions to use appropriate GN arg

2017-05-22 17:32:49 +00:00

angle_in_chromium.md

Fix spelling mistakes in //docs.

2016-12-02 22:16:53 +00:00

atom.md

Add content from Sites to Atom guide.

2016-12-06 02:51:01 +00:00

bitmap_pipeline.md

…

browser_view_resizer.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

callback.md

Docs: Add note about std::move() resetting a Callback.

2017-07-14 21:29:32 +00:00

ccache_mac.md

…

chrome_settings.md

Remove chrome://settings-frame on CrOS

2017-07-26 16:52:25 +00:00

chromium_browser_vs_google_chrome.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

chromoting_android_hacking.md

Remove obsolete unused file.

2017-01-11 17:02:44 +00:00

cl_respect.md

Add "Respectful Changes" to Chromium docs.

2017-07-29 00:32:58 +00:00

clang_format.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

clang_static_analyzer.md

Update Clang static analysis Markdown doc.

2017-07-13 02:57:21 +00:00

clang_tidy.md

Remove references to debian wheezy sysroot

2017-05-10 17:45:03 +00:00

clang_tool_refactoring.md

Add a clang tool to detect std::move(raw ptr)

2017-06-09 07:30:42 +00:00

clang.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

closure_compilation.md

Add instructions for the Closure externs generator

2017-05-01 23:40:59 +00:00

cocoa_tips_and_tricks.md

…

code_reviews.md

Update for Gerrit in code review docs

2017-07-20 01:55:11 +00:00

common_build_tasks.md

Redirect links to faster-builds tips to newly merged Linux instructions

2016-12-08 02:12:05 +00:00

component_build.md

Add a common mistake case for header-only classes in components build doc

2017-02-17 22:41:21 +00:00

cr_respect.md

Add "Respectful Changes" to Chromium docs.

2017-07-29 00:32:58 +00:00

cr_user_manual.md

Fix spelling mistakes in //docs.

2016-12-02 22:16:53 +00:00

cygwin_dll_remapping_failure.md

…

documentation_best_practices.md

Update web-platform-tests docs

2017-02-15 15:03:16 +00:00

documentation_guidelines.md

Add Chromium documentation guidelines.

2017-02-14 03:55:39 +00:00

eclipse.md

Update Eclipse classpath and documentation for running JUnit tests.

2017-05-03 09:47:28 +00:00

emacs.md

Fix spelling mistakes in //docs.

2016-12-02 22:16:53 +00:00

erc_irc.md

…

es6_chromium.md

WebUI style: Allow ES6 let/const usage.

2017-07-22 01:33:34 +00:00

fuchsia_build_instructions.md

Fix fuch->fuchsia and add note re Debug maybe working.

2017-07-12 01:09:26 +00:00

fuchsia_sdk_updates.md

Update Fuchsia SDK instructions to include netstack

2017-07-21 18:46:15 +00:00

get_the_code.md

Move ios documentation from //docs to //docs/ios.

2017-03-06 22:12:02 +00:00

git_cookbook.md

Update docs/git_cookbook.md to remove references to svn

2017-07-13 15:34:46 +00:00

git_tips.md

git tips: Add instructions about displaying commit date

2017-06-13 15:01:11 +00:00

google_play_services.md

[gmscore] Add Google Play services documentation

2016-12-06 18:58:54 +00:00

graphical_debugging_aid_chromium_views.md

…

gtk_vs_views_gtk.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

how_to_extend_layout_test_framework.md

Fix spelling mistakes in //docs.

2016-12-02 22:16:53 +00:00

installation_at_vmware.md

[Docs] Another round of stylistic fixes.

2015-08-31 02:28:22 +00:00

ios_build_instructions.md

Move ios documentation from //docs to //docs/ios.

2017-03-06 22:12:02 +00:00

ios_infra.md

Move ios documentation from //docs to //docs/ios.

2017-03-06 22:12:02 +00:00

ios_voiceover.md

Move ios documentation from //docs to //docs/ios.

2017-03-06 22:12:02 +00:00

ipc_fuzzer.md

Fix spelling mistakes in //docs.

2016-12-02 22:16:53 +00:00

jumbo.md

Make multiple jumbo_* templates instead of just jumbo_target

2017-07-19 11:23:52 +00:00

kiosk_mode.md

…

layout_tests_linux.md

Remove stray doc references to valgrind.

2017-01-17 01:39:38 +00:00

linux_build_instructions_prerequisites.md

…

linux_build_instructions.md

Update linux build instructions to reflect that the sysroot can be used with gcc

2017-07-19 20:26:09 +00:00

linux_building_debug_gtk.md

[Docs] Another round of stylistic fixes.

2015-08-31 02:28:22 +00:00

linux_cast_build_instructions.md

Add the missing Cast build instructions.

2017-04-04 02:35:01 +00:00

linux_cert_management.md

[Docs] fixes

2015-09-01 04:27:19 +00:00

linux_chromium_arm.md

Remove wheezy sysroot images support

2017-04-05 19:36:16 +00:00

linux_chromium_packages.md

…

linux_crash_dumping.md

…

linux_debugging_gtk.md

[Docs] fixes

2015-09-01 04:27:19 +00:00

linux_debugging_ssl.md

…

linux_debugging.md

Remove stray doc references to valgrind.

2017-01-17 01:39:38 +00:00

linux_dev_build_as_default_browser.md

…

linux_development.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

linux_eclipse_dev.md

Minor clean ups to linux_eclipse_dev.md

2017-05-05 18:06:06 +00:00

linux_graphics_pipeline.md

[Docs] fixes

2015-09-01 04:27:19 +00:00

linux_gtk_theme_integration.md

Gtk3: More fixes and refactorings

2017-02-10 20:05:48 +00:00

linux_hw_video_decode.md

…

linux_minidump_to_core.md

docs: Change "ChromeOS" to "Chrome OS".

2017-02-22 17:57:55 +00:00

linux_password_storage.md

…

linux_pid_namespace_support.md

…

linux_plugins.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

linux_profiling.md

Remove stray doc references to valgrind.

2017-01-17 01:39:38 +00:00

linux_proxy_config.md

…

linux_sandbox_ipc.md

…

linux_sandboxing.md

Update web-platform-tests docs

2017-02-15 15:03:16 +00:00

linux_sublime_dev.md

Markdown formatting nit to fix a link in docs.

2017-02-22 14:10:48 +00:00

linux_suid_sandbox_development.md

…

linux_suid_sandbox.md

docs: remove reference to linux_sandbox_path GYP variable

2017-05-22 14:53:27 +00:00

linux_sysroot.md

Update linux-sysroot.md

2016-12-15 23:39:34 +00:00

linux_zygote.md

fix references to zygote_host_linux.cc

2017-05-25 14:06:05 +00:00

mac_build_instructions.md

Change Run Chromium section in mac_build_instructions.md

2017-06-28 21:21:46 +00:00

mandriva_msttcorefonts.md

…

new_port_policy.md

Add information on the requirements for a new Chromium port.

2017-05-30 16:33:38 +00:00

old_chromeos_build_instructions.md

docs: Change "ChromeOS" to "Chrome OS".

2017-02-22 17:57:55 +00:00

old_chromoting_build_instructions.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

optimizing_web_uis.md

WebUI: Replace vulcanize with polymer-bundler.

2017-07-22 00:22:25 +00:00

optional.md

use namespace base for base::make_optional in docs

2017-03-15 02:44:26 +00:00

origin_trials_integration.md

Update Origin Trials integration docs.

2017-07-20 03:43:48 +00:00

OWNERS

…

ozone_overview.md

Update Ozone documentation for Linux Desktop

2017-04-05 18:06:14 +00:00

piranha_plant.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

profiling_content_shell_on_android.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

proxy_auto_config.md

Fix spelling mistakes in //docs.

2016-12-02 22:16:53 +00:00

qtcreator.md

remove gdb_index in qtcreator document

2017-03-27 21:43:16 +00:00

README.md

Add "Respectful Changes" to Chromium docs.

2017-07-29 00:32:58 +00:00

retrieving_code_analysis_warnings.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

seccomp_sandbox_crash_dumping.md

…

servicification.md

Add documentation on servicification recipes

2017-05-02 09:08:49 +00:00

shift_based_development.md

…

subtle_threading_bugs.md

Port https://sites.google.com/a/chromium.org/dev/developers/design-documents/threading/suble-threading-bugs-and-patterns-to-avoid-them to in-repo documentation. This is a straight port is almost no content editing.

2017-05-17 00:37:25 +00:00

system_hardening_features.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

tab_helpers.md

…

task_scheduler_migration.md

Add migration hint for OverrideThreadForMessage().

2017-07-27 00:53:33 +00:00

test_descriptions.md

…

threading_and_tasks.md

Use macros for SequenceChecker docs.

2017-06-27 19:18:30 +00:00

tpm_quick_ref.md

…

updating_clang_format_binaries.md

fix a README link

2017-02-28 00:06:07 +00:00

updating_clang.md

Add linux_chromium_cfi_rel_ng to list of clang roll tryjobs.

2017-07-13 17:25:32 +00:00

use_find_bugs_for_android.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

useful_urls.md

Update links in useful URLs doc

2017-07-19 20:18:20 +00:00

user_data_dir.md

Fix broken link in user_data_dir.md, one more try.

2017-07-06 01:02:49 +00:00

user_handle_mapping.md

Add Hexcles--robertma to handle mapping

2017-07-19 18:42:22 +00:00

using_a_linux_chroot.md

Update web-platform-tests docs

2017-02-15 15:03:16 +00:00

using_build_runner.md

A batch of docs style fixes.

2015-08-25 17:16:40 +00:00

vanilla_msysgit_workflow.md

Fix spelling mistakes in //docs.

2016-12-02 22:16:53 +00:00

vscode.md

Fix VSCode You-Complete-Me docs

2017-06-23 16:39:12 +00:00

webui_explainer.md

Fix \t vs \s errors in webui_explainer.md

2017-06-16 22:36:18 +00:00

webview_policies.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

windows_build_instructions.md

Fix faster builds documentation of enable_nacl

2017-07-28 17:12:20 +00:00

windows_split_dll.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

working_remotely_with_android.md

Fix spelling mistakes in //docs.

2016-12-02 22:16:53 +00:00

writing_clang_plugins.md

Use HTTPS links for Google domains in docs

2016-12-06 02:53:51 +00:00

README.md

Chromium docs

This directory contains chromium project documentation in Gitiles-flavored Markdown. It is automatically rendered by Gitiles.

If you add new documents, please also add a link to them in the Document Index below.

[TOC]

Creating Documentation

Markdown documents must follow the style guide.

Preview local changes using md_browser:

# in chromium checkout
./tools/md_browser/md_browser.py

This is only an estimate. The gitiles view may differ.

Review changes online with gerrit's links to gitiles:

Upload a patch to gerrit, or receive a review request. e.g. https://chromium-review.googlesource.com/c/572236
View a specific .md file. e.g. https://chromium-review.googlesource.com/c/572236/2/docs/README.md
Click on gitiles link at top of page.

This gitiles view is the authoritative view, exactly the same as will be used when committed.

Document Index

Checking Out and Building

Linux Build Instructions - Linux
Mac Build Instructions - MacOS
Windows Build Instructions - Windows
Android Build Instructions - Android target (on a Linux host)
Cast Build Instructions - Cast target (on a Linux host)
Cast for Android Build Instructions - Cast for Android (on a Linux host)
iOS Build Instructions - iOS target (on a MacOS host)
Linux Chromium ARM Recipes - Recipes for building Chromium for ARM on Linux.
Common Build Tasks - Recipes for slightly more advanced build tasks
Chrome Component Build - Faster builds using more libraries
Using the BuildRunner - Scripts that extract build stops from builders and runs them locally on a slave
Cr User Manual - Manual for cr, a tool that tries to hide some of the tools used for working on Chromium behind an abstraction layer

Design Docs

See design/README.md

Integrated Development Environment (IDE) Set Up Guides

Android Studio - Android Studio for Android builds
Eclipse for Android - Eclipse for Android
Eclipse for Linux - Eclipse for other platforms (This guide was written for Linux, but is probably usable on Windows/MacOS as well)
Qt Creator - Using Qt Creator as an IDE or GUI debugger
Setting up Visual Studio Code - Visual Studio Code
EMACS Notes - EMACS commands/styles/tool integrations
Atom - Atom multi-platform code editor

Git

Git Cookbook - A collection of git recipes for common tasks
Git Tips - More git tips

Clang

Clang Compiler - General information on the clang compiler, used by default on Mac and Linux
Clang Tool Refactoring - Leveraging clang tools to perform refactorings that are AST-aware
The Clang Static Analyzer - How to enable static analysis at build time
Writing Clang Plugins - Don't write a clang plugin, but if you do, read this
Updating Clang - Updating the version of Clang used to build
Using clang-format on Chromium C++ Code - Various ways to invoke clang-format on C++ code
Clang Tidy - Support for the clang-tidy tool in Chromium
Updating Clang Format Binaries - How up update the clang-format binaries that come with a checkout of Chromium

General Development

Code Reviews - Code review requirements and guidelines
Respectful Code Reviews - A guide for code reviewers
Respectful Changes - A guide for code authors
Closure Compilation - The Closure JavaScript compiler
Threading and Tasks in Chrome - How to run tasks and handle thread safety in Chrome.
Subtle Threading Bugs and Patterns to Avoid Them - Threading pitfalls to avoid.
Callback<> and Bind() - All about Callbacks, Closures, and Bind().
Views Platform Styling - How views are styled to fit in different native platforms
Tab Helpers - Using WebContents/WebContentsObserver to add features to browser tabs.
Adding third_party Libraries - How to get code into third_party/
Graphical Debugging Aid for Chromium Views - Visualizing view trees during debugging
Bitmap Pipeline - How bitmaps are moved from the renderer to the screen.
base::Optional - How to use base::Optional in C++ code.
Using the Origin Trials Framework - A framework for conditionally enabling experimental APIs for testing.
SharedModelTypeProcessor in Unified Sync and Storage - Notes on the central data structure used in Chrome Sync.
Chrome Sync's Model API - Data models used for syncing information across devices using Chrome Sync.
Ozone Overview - Ozone is an abstraction layer between the window system and low level input and graphics.
Optimizing Chrome Web UIs - Notes on making webuis more performant
ES6 Support in Chromium - Implementation of ECMAScript6 features in Chromium

Testing

Running and Debugging Layout Tests
Writing Layout Tests - Layout Tests using content_shell
Layout Test Expectations and Baselines - Setting expected results of layout tests.
Layout Tests Tips - Best practices for Layout Tests
Layout Tests with Manual Fallback - Writing tests that simulate manual interventions
Extending the Layout Test Framework
Fixing Layout Test Flakiness - Diagnosing and fixing layout test flakiness due to ordering dependencies.
Running Layout Tests using content_shell - Running layout tests by hand.
Testing Browser Dialogs - Using TestBrowserDialog
Web Platform Tests - Shared tests across browser vendors
Using Breakpad with content_shell - Capture stack traces on layout test crashes without an attached debugger
Test Descriptions - Unit test targets that can be built, with associated desciptions.
IPC Fuzzer - Fuzz testing of Chromium IPC interfaces.

Misc Linux-Specific Docs

Linux Proxy Config - Network proxy sources on Linux
Debugging SSL on Linux - Tips on debugging SSL code in Linux
Linux Cert Managment - Managing X.509 Certificates in Linux
Tips for Debugging on Linux
Linux GTK Theme Integration - Having Chrome match the GTK+ theme.
Gtk vs ViewsGtk - Notes on when to use Gtk vs ViewsGtk
Browser Plugins on Linux - A collection of links to information on how browser plugins work on Linux
Linux Crash Dumping - How Breakpad uploads crash reports to Google crash servers.
Linux Minidump to Core - How to convert a Breakpad-generated minidump files to a core file readable by most debuggersx
Linux Sandbox IPC - The lower level UPC system used to route requests from the bottom of the call stack up into the browser.
Linux Dev Build as Default Browser - How to configure a Dev build of Chrome as the default browser in Linux.
Linux Chromium Packages - Packages of Chromium browser (not Chrome) provided by some Linux distributions.
seccomp Sandbox Crash Dumping - Notes on crash dumping a process running in a seccomp sandbox.
Linux Password Storage - Keychain integrations between Chromium and Linux.
Linux Sublime Development - Using Sublime as an IDE for Chromium development on Linux.
Building and Debugging GTK - Building Chromium against GTK using lower optimization levels and/or more debugging symbols.
Debugging GTK - Using the GTK Debug packages and related tools.
Chroot Notes - Setting up a chroot to work around libfreetype differences in some versions of Linux.
Linux Sandboxing - The Linux multi-process model to isolate browser components with different privileges.
Zygote Process - How the Linux Zygote process, used to spawn new processes, works.
Running Layout Tests on Linux - Linux-specific instructions for running layout tests.
Linux Sysroot Images - How builds use libraries on Linux
msttcorefonts on Mandriva - Getting fonts needed to build Chrome that are not available for Mandriva
Linux Hardware Video Decoding - Enabling hardware video decode codepaths on Linux

Misc MacOS-Specific Docs

Using CCache on Mac - Speed up builds on Mac using ccache with clang/ninja
Cocoa tips and tricks - A collection of idioms used when writing Cocoa views and controllers
MacViews Release Plan

Misc Windows-Specific Docs

Handling cygwin rebaseall failures
Hacking on ANGLE in Chromium - OpenGL ES 2.0 built on top of DirectX
Retrieveing Code Analysis Warnings - How to retrieve and summarize the warnings generated by Microsoft VC++'s /analyze compile option.
Windows Split DLLs - Splitting chrome.dll into multiple dlls to work around toolchain limitations on Windows.

Misc Android-Specific Docs

Google Play Services in Chrome for Android
Accessing C++ Enums in Java - How to use C++-defined enums in Java code
Profiling Content Shell on Android - Setting up profiling for content_shell on Android
Working Remotely with Android - Building on a remote machine for an Android device connected to your local machine
Using FindBugs for Android - Using the open source static analysis tool findbugs on the Java code.
Android Test Instructions - Running a build on an Android device or emulator.
Android Debugging - Tools and tips for how to debug Java and/or C/C++ code running on Android.
Android Logging - How Chrome's logging API works with android.util.Log on Android, and usage guidelines.
Chromoting Android Hacking - Viewing the logs and debugging the Chrome Remote Desktop Android client.

Misc iOS-Specific Docs

Continuous Build and Test Infrastructure for Chromium for iOS
Opening links in Chrome for iOS - How to have your iOS app open links in Chrome.
User Agent in Chrome for iOS - Notes on User Agent strings using Chrome for iOS.

Media

Audio Focus Handling - How multiple MediaSession audio streams interact
Autoplay of HTMLMediaElements - How HTMLMediaElements are autoplayed.
Piranha Plant - Future architecture of MediaStreams

Accessibility

Accessibility Overview - Overview of accessibility concerns and approaches in Chromium.
Accessibility Tests - Where to find accessibility-related tests in the codebase.
ChromeVox on Chrome OS - Enabling spoken feedback (ChromeVox) on Chrome OS.
ChromeVox on Desktop Linux - Enabling spoken feedback (ChromeVox) on desktop Linux.
BRLTTY in Chrome OS - Chrome OS integration with BRLTTY to support refreshable braille displays
PATTS on Chrome OS - Notes on the PATTS speech sythesis engine used on Chrome OS
VoiceOver - Using Apple's VoiceOver feature with Chromium on iOS.

Memory Infrastructure Timeline Profiling (MemoryInfra)

Misc

Useful URLs - A collection of links to various tools and dashboards
ERC IRC - Using ERC in EMACS to access IRC
Kiosk Mode - Simulating kiosk mode.
User Handle Mapping - Names of developers across Chromium/IRC/Google
Documentation Best Practices
Documentation Guidelines
Shift-Based Development - An experiment in handing off development of coordinated work between developers in different time zones.
Chromium Browser vs Google Chrome - What's the difference between Chromium Browser and Google Chrome?
Proxy Auto Config using WPAD - How WPAD servers are used to automatically set proxy settings.
Installing Chromium OS on VMWare - How to install Chromium OS on VMWare.
User Data Directory - How the user data and cache directories are determined on all platforms.

Probably Obsolete

Old ChromeOS build instructions
TPM Quick Reference - Trusted Platform Module notes.
System Hardening Features - A list of current and planned Chrome OS security features.
Browser View Resizer - Design doc for making browser window resizing easier on Windows.
WebView Policies
Linux Profiling - How to profile Chromium on Linux
Linux Graphics Pipeline
Linux SUID Sandbox - Sandboxing renderers using a SUID binary on Linux
Linux SUID Sandbox Development - Development on the above system.
Linux PID Namespace Support
Vanilla msysgit workflow - A workflow for using mostly vanilla git on Windows.
Old Chromoting Build Instructions
Old Options - Pre-Material Design chrome://settings notes.