0

Fix various issues with Markdown docs

- Removed links to old wiki pages
- Fixed broken table in test_descriptions.md
- Fixed tables that don't have heading
- Fix codeblock in common_build_tasks.md

Review URL: https://codereview.chromium.org/1473953002

Cr-Commit-Position: refs/heads/master@{#361773}
This commit is contained in:
sbc
2015-11-25 16:50:52 -08:00
committed by Commit bot
parent b1233f42c8
commit 9f033f816b
12 changed files with 73 additions and 79 deletions

@@ -11,7 +11,7 @@ page is about using ccache on Mac with clang and the NinjaBuild system.
## Installation
In order to use [ccache](http://ccache.samba.org) with
[clang](http://code.google.com/p/chromium/wiki/Clang), you need to use the
[clang](clang.md), you need to use the
current [git HEAD](http://ccache.samba.org/repo.html), since the most recent
version (3.1.9) doesn't contain the
[patch needed](https://github.com/jrosdahl/ccache/pull/4) for using

@@ -36,8 +36,7 @@ If you've already checked out a copy of the browser's codebase, you can skip
this section, although you'll still need to run `gclient runhooks` to ensure you
build using the API keys you just generated.
1. Install the build dependencies, which are listed at
http://code.google.com/p/chromium/wiki/LinuxBuildInstructionsPrerequisites.
1. [Install the build dependencies](linux_build_instructions_prerequisites.md).
1. Install the depot\_tools utilities, a process that is documented at
http://dev.chromium.org/developers/how-tos/install-depot-tools.
1. Download the Chromium source code by running:
@@ -111,8 +110,8 @@ very early stages of development. At the time of writing, you must compile from
source because no official version is being distributed.
1. Follow all the instructions under the `Getting the code` and
`Install prerequisites` sections of: TODO: 404
http://code.google.com/p/chromium/wiki/AndroidBuildInstructions
`Install prerequisites` sections of:
https://www.chromium.org/developers/how-tos/android-build-instructions
1. Move into the `src/` directory that contains your checkout of the Chromium
code.
1. Build the Android app: `$ ninja -C out/Release remoting_apk`

@@ -67,11 +67,11 @@ system GYP when generating project files. This is a summary of them:
TODO(andybons): Convert to list.
| GYP\_DEFINES | A set of key=value pairs separated by space that will set default values of variables used in .gyp and .gypi files |
|:-------------|:-------------------------------------------------------------------------------------------------------------------|
| GYP\_GENERATORS | The specific generator that creates build-system specific files |
| GYP\_GENERATOR\_FLAGS | Flags that are passed down to the tool that generates the build-system specific files |
| GYP\_GENERATOR\_OUTPUT | The directory that the top-level build output directory is relative to |
|:-------------|:--------------------------------------------------------------|
| `GYP_DEFINES` | A set of key=value pairs separated by space that will set default values of variables used in .gyp and .gypi files |
| `GYP_GENERATORS` | The specific generator that creates build-system specific files |
| `GYP_GENERATOR_FLAGS` | Flags that are passed down to the tool that generates the build-system specific files |
| `GYP_GENERATOR_OUTPUT` | The directory that the top-level build output directory is relative to |
Note also that GYP uses CPPFLAGS, CFLAGS, and CXXFLAGS when generating ninja
files (the values at build time = ninja run time are _not_ used); see
@@ -89,12 +89,14 @@ Next to your top-level `/src/` directory, create a file called
above environment variables. For the full list of supported keys, see
[/src/build/gyp_helper.py](/build/gyp_helper.py).
``` {
```
{
'variables': {
'mac_strip_release': 0,
}, 'GYP_DEFINES':
'clang=1 ' 'component=shared_library ' 'dcheck_always_on=1 '
} ```
}
```
#### include.gyp

@@ -26,7 +26,7 @@ Here's an overview of the steps you'll run:
to check out Chromium.
1. We don't provide any sort of "install" step.
1. You may want to
[use a chroot](http://code.google.com/p/chromium/wiki/UsingALinuxChroot) to
[use a chroot](using_a_linux_chroot.md) to
isolate yourself from versioning or packaging conflicts (or to run the
layout tests).

@@ -26,9 +26,9 @@ and library dependencies directly from Ubuntu:
$ ./build/install-build-deps.sh
### Installing the rootfs
### Installing the sysroot
A prebuilt rootfs image is kept up-to-date on Cloud Storage. It will
A prebuilt sysroot image is kept up-to-date on Cloud Storage. It will
automatically be installed by gclient runhooks installed if you have
`target_arch=arm` in your `GYP_DEFINES`.

@@ -439,8 +439,7 @@ and rebuild.
See
https://sites.google.com/a/chromium.org/dev/developers/profiling-chromium-and-webkit
and
http://code.google.com/p/chromium/wiki/LinuxProfiling
and [Linux Profiling](linux_profiling.md).
## i18n

@@ -140,8 +140,7 @@ for 'dynamic' since dynamic transitions are a little obscure in SELinux)
Sandboxing can make developing harder, see:
* [this page](https://code.google.com/p/chromium/wiki/LinuxSUIDSandboxDevelopment)
for the `setuid` sandbox
* [this page](linux_suid_sandbox_development.md) for the `setuid` sandbox
* [this page](http://www.chromium.org/for-testers/bug-reporting-guidelines/hanging-tabs)
for triggering crashes
* [this page for debugging tricks](linux_debugging.md)

@@ -58,9 +58,7 @@ done in your separate local repositories, and you still use e.g. git
pull (which in our git svn repositories behind the scenes does a `git svn fetch` etc.
Shift-based collaboration won't work well (at least not with a
pipeline of branches) unless you are using an "unmanaged" git checkout
(search for "unmanaged" on
[this page](https://code.google.com/p/chromium/wiki/UsingNewGit)).
pipeline of branches) unless you are using an "unmanaged" git checkout.
## Example Working Rules

@@ -1,7 +1,7 @@
See [Testing and infrastructure](https://sites.google.com/a/chromium.org/dev/developers/testing) for more information.
|:-----------------------|:-|
|accessibility\_unittests| |
|:-----------------------|:|
|angle\_unittests | |
|app\_list\_unittests | |
|ash\_unittests | |

@@ -5,8 +5,8 @@ This page aims to be a repository of useful links that people may find useful.
## Build Status
| http://build.chromium.org/p/chromium/console | Main buildbot waterfall |
|:---------------------------------------------|:------------------------|
| http://build.chromium.org/p/chromium/console | Main buildbot waterfall |
| http://chromium-status.appspot.com/lkgr | Last Known Good Revision. Trybots pull this revision from trunk. |
| http://chromium-status.appspot.com/revisions | List of the last 100 potential LKGRs |
| http://build.chromium.org/p/chromium/lkgr-status/ | Status dashboard for LKGR |
@@ -19,8 +19,8 @@ This page aims to be a repository of useful links that people may find useful.
## For Sheriffs
| http://build.chromium.org/p/chromium.chromiumos/waterfall?show_events=true&reload=120&failures_only=true | List of failing bots for a waterfall (chromium.chromiumos as an example) |
|:---------------------------------------------------------------------------------------------------------|:-------------------------------------------------------------------------|
| http://build.chromium.org/p/chromium.chromiumos/waterfall?show_events=true&reload=120&failures_only=true | List of failing bots for a waterfall (chromium.chromiumos as an example) |
| http://build.chromium.org/p/chromium.linux/waterfall?show_events=true&reload=120&builder=Linux%20Builder%20x64&builder=Linux%20Builder%20(dbg) | Monitor one or multiple bots (Linux Builder x64 and Linux Builder (dbg) on chromium.linux as an example) |
| http://build.chromium.org/p/chromium.win/waterfall/help | Customize the waterfall view for a waterfall (using chromium.win as an example) |
| http://chromium-sheriffing.appspot.com | Alternate waterfall view that helps with test failure triage |
@@ -28,14 +28,14 @@ This page aims to be a repository of useful links that people may find useful.
## Release Information
| https://omahaproxy.appspot.com/viewer | Current release versions of Chrome on all channels |
|:--------------------------------------|:---------------------------------------------------|
| https://omahaproxy.appspot.com/viewer | Current release versions of Chrome on all channels |
| https://omahaproxy.appspot.com/ | Looks up the revision of a build/release version |
## Source Information
| http://cs.chromium.org/ | Code Search |
|:------------------------|:------------|
| http://cs.chromium.org/ | Code Search |
| http://cs.chromium.org/SEARCH_TERM | Code Search for a specific SEARCH\_TERM |
| http://src.chromium.org/viewvc/chrome/ | ViewVC History Viewer |
| http://git.chromium.org/gitweb/?p=chromium.git;a=summary | Gitweb History Viewer |
@@ -45,8 +45,6 @@ This page aims to be a repository of useful links that people may find useful.
## Communication
| http://groups.google.com/a/chromium.org/group/chromium-dev/topics | Chromium Developers List |
|:------------------------------------------------------------------|:-------------------------|
| http://groups.google.com/a/chromium.org/group/chromium-dev/topics | Chromium Developers List |
| http://groups.google.com/a/chromium.org/group/chromium-discuss/topics | Chromium Users List |
| http://code.google.com/p/chromium/source/list | Wiki History (SVN-based) |
| http://code.google.com/p/chromium/wiki/UserHandleMapping | Chromium User Mapping |

@@ -45,33 +45,33 @@ For Chromium contributors that have different nicks on other domains.
| jchaffraix | jchaffraix | jchaffraix |
| jeremy | jeremymos | playmobil |
| jln | julien\` | jln |
| jochen | jochen`__` | eisinger |
| johnnyg | johnny_g | johnnyg |
| jochen | jochen\_\_ | eisinger |
| johnnyg | johnny\_g | johnnyg |
| joi | joisig | joi |
| jonross | jonrossca | jonross |
| jshin | jshin | jungshik |
| jww | jww__ | jww |
| jww | jww\_\_ | jww |
| jyasskin | jyasskin | jyasskin |
| karen | kareng | kareng |
| keescook | kees | keescook |
| koz | | jameskozianski |
| kuchhal | kuchhal | rahulk |
| levin | dave_levin | levin |
| lfg | lfg_ | lfg |
| levin | dave\_levin | levin |
| lfg | lfg\_ | lfg |
| luken | luken_chromium | luken |
| mark | markmentovai | mmentovai |
| mattm | mattm_c, mattm_g | mattm |
| mattm | mattm\_c, mattm\_g | mattm |
| mbarbella | mbarbella | mbarbella |
| mmeade | mmeade | mmeade |
| mednik | mednik | mednik |
| mgaba | mgaba | mgaba |
| mlinck | dullb0yj4ck | mlinck |
| msw | msw_ | msw |
| msw | msw\_ | msw |
| nick | nickcarter | ncarter |
| oleg | | olege |
| ortuno | gortuno | ortuno |
| pam | pamg | pamg |
| paulirish | paul_irish | paulirish |
| paulirish | paul\_irish | paulirish |
| patrick | pjohnson | pjohnson |
| peter | beverloo | beverloo |
| phajdan.jr | phajdan-jr | phajdan |
@@ -82,7 +82,7 @@ For Chromium contributors that have different nicks on other domains.
| robliao | robliao | robliao |
| rsleevi | sleevi, rsleevi | sleevi |
| sarah | | sarahgordon |
| satish | satish`_` | satish |
| satish | satish\_ | satish |
| scheglov | | scheglov |
| scottbyer | sbyer | scottbyer |
| shans | | shanestephens |
@@ -99,7 +99,7 @@ For Chromium contributors that have different nicks on other domains.
| vadimt | vadimt | vadimt |
| viettrungluu | trungl | vtl |
| wad | redpig | drewry |
| wez | real_wez | wez |
| wez | real\_wez | wez |
| wjmaclean | seumas, wjmaclean | wjmaclean, wjm, seumas |
| yoz | yaws | yoz |
| zmo | zhenyao | zmo |

@@ -11,5 +11,4 @@ reason.
Note that `incremental_chrome_dll=1` will probably not work on Visual Studio
2008 builds. It may not work on Visual Studio 2010 builds either (pamg couldn't
get it to work as of Nov 2012, encountering numerous link errors). You may have
to use [ninja](http://code.google.com/p/chromium/wiki/NinjaBuild), which has
incremental linking on by default.
to use [ninja](ninja_build.md), which has incremental linking on by default.