Files

Steve Kobes 22fb19cd6e Document user data directory logic.

Incorporates all of https://www.chromium.org/user-experience/user-data-directory
which can now be a redirect.  Adds some things that weren't documented,
including guidance on the new $CHROME_CONFIG_HOME variable.

Bug: 726016
Change-Id: I91944f04ffbcfbd268c8d18d2121ffd1b5f54a70
Reviewed-on: https://chromium-review.googlesource.com/558653
Reviewed-by: Lei Zhang <thestig@chromium.org>
Commit-Queue: Steve Kobes <skobes@chromium.org>
Cr-Commit-Position: refs/heads/master@{#484358}

2017-07-05 21:49:08 +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 a path to the generated Xcode workspace in the build document.

2017-05-18 05:50:32 +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

Add documentation in memory_benchmarks.md on finding links to trace files

2017-06-23 14:08:35 +00:00

process

Add Chrome release cycle documentation

2017-06-20 01:08:25 +00:00

speed

Tweak apk_size_regressions.md bug template

2017-06-30 16:10:18 +00:00

sync

[Sync] Adding missing DependsOn to *ProfileSyncServiceFactory.

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

testing

Clarify docs and note in wpt-importer commit descriptions.

2017-06-07 02:34:44 +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

Fix typo in 'adding_to_third_party.md' doc.

2017-04-19 17:24:38 +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

Update stale links to Android Debugging Instructions

2017-05-18 16:44:16 +00:00

android_cast_build_instructions.md

Update stale links to Android Debugging Instructions

2017-05-18 16:44:16 +00:00

android_debugging_instructions.md

android: Convert java_deobfuscate.py to Java

2017-07-05 15:27:17 +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

Update //docs/callback.md for OnceCallback support of PostTask impls

2017-04-24 06:14:13 +00:00

ccache_mac.md

…

chrome_settings.md

[MD settings] update docs to refer to $i18n

2017-05-16 01:14:07 +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

clang_format.md

Use HTTPS links for Google domains in docs

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

clang_static_analyzer.md

Remove dependency on scan-build wrapper script for analysis builds.

2017-03-10 19:47: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

Add examples for some scenarios in the code review docs.

2017-06-09 22:05:32 +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_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

Move Map/Set to allowed features of ES6 styleguide.

2017-06-29 23:10:40 +00:00

fuchsia_build_instructions.md

fuchsia docs: clarify where target_os goes

2017-06-30 21:31:37 +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

git cookbook: add links to depot_tools man pages and tutorial

2017-05-17 19:21:19 +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

…

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

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

Use name attribute not id attribute for anchor tag in Markdown

2016-12-09 22:50:17 +00:00

linux_building_debug_gtk.md

…

linux_cast_build_instructions.md

Add the missing Cast build instructions.

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

linux_cert_management.md

…

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

…

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

…

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

Remove references to or invocations of vulcanize.py. It's deleted.

2017-02-11 20:58:07 +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

Cleanup virtual test suites for origin trials

2017-02-23 18:16:17 +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

Document user data directory logic.

2017-07-05 21:49:08 +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 more mappings for migration to SequencedTaskRunner

2017-07-05 07:19:06 +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

Stop building the gold plugin and linking lld against tcmalloc.

2017-06-28 21:30:44 +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 useful_urls.md links to HTTPS.

2017-02-07 03:27:18 +00:00

user_data_dir.md

Document user data directory logic.

2017-07-05 21:49:08 +00:00

user_handle_mapping.md

Add johnchen/zhanliang to user_handle_mapping.md

2017-04-21 02:30:42 +00:00

using_a_linux_chroot.md

Update web-platform-tests docs

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

using_build_runner.md

…

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

Update Windows enlist and build instructions

2017-06-20 18:47:50 +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]

Style guide

Markdown documents must follow the style guide.

Previewing changes

You can preview your local changes using md_browser:

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

To review someone else's changes, apply them locally first:

# in chromium checkout
git cl patch <CL number or URL>
./tools/md_browser/md_browser.py

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
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.