Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(814)

Unified Diff: tools/gn/README.md

Issue 1393863003: Update tools/gn/README.md. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: patch for review Created 5 years, 2 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « no previous file | no next file » | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: tools/gn/README.md
diff --git a/tools/gn/README.md b/tools/gn/README.md
index 90cf9085406240f172ea0812ac3a5bb8251a6047..f9679eb30746fdaeb85f513dae7187366e27df9c 100644
--- a/tools/gn/README.md
+++ b/tools/gn/README.md
@@ -1,7 +1,7 @@
# What is GN?
GN is a meta-build system that generates
-[NinjaBuild](https://chromium.googlesource.com/chromium/src/+/master/docs/ninja_build.md)
+[NinjaBuild](/chromium/src/+/master/docs/ninja_build.md)
files. It's meant to be faster and simpler than GYP. It outputs only Ninja build
files.
@@ -10,10 +10,7 @@ files.
1. We believe GN files are more readable and more maintainable
than GYP files.
2. GN is fast:
- * GN is 20x faster than GYP (as of mid November, building 80%
- of what GYP builds, in one configuration rather than two, takes 500ms
- on a z620 running Ubuntu Trusty. GYP takes 20 seconds.
- We see similar speedups on Mac and Windows).
+ * GN is 20x faster than GYP.
* GN supports automatically re-running itself as needed by Ninja
as part of the build. This eliminates the need to remember to
re-run GN when you change a build file.
@@ -25,30 +22,23 @@ files.
## What's the status?
-_as of 8 Feb 2015:_
+_as of 7 Oct 2015:_
-Chrome and most of the major test suites link on Linux and ChromeOS.
-There's probably <1000 objects left to build, in a few test suites and a
-bunch of utillities and helper binaries. We will probably have
-everything converted in another couple weeks.
+GN is now the default system for Linux, though GYP still works. It
+is mostly complete on Android, ChromeOS, and Windows (apart from NaCl
+support on Windows).
-Chrome also links on Android and Windows, and bringing up the remaining
-test suites should be mostly straightforward. There's some work left to
-enable NaCl on Windows but it should also be straightforward.
-
-Mac and iOS have not progressed much as attention has been focused on
-Linux and Windows; we still need support for bundles and frameworks
-before it can get to parity w/ the other platforms.
+Mac and iOS are making progress, though we still need better support
+for bundles before the major targets like Chrome can link and they get
+to parity w/ the other platforms.
## When are you going to be done?
-_as of 8 Feb 2015:_
+_as of 7 Oct 2015:_
-We're currently shooting for having the main developer configurations
-working and usable by the end of March 2015. There will probably be a
-fair amount of verification of flags, bug fixes, etc over the next
-couple months, but hopefully we will be flipping configurations from GYP
-to GN throughout Q2, targeting having everything done by the end of Q2.
+We're currently shooting for having Android, ChromeOS, and Windows
+converted over by the end of 2015, with Mac and iOS following in Q1
+of 2016.
## What does "done" mean?
@@ -85,21 +75,20 @@ so we would at least look at patches adding the functionality.
Check to see if your targets build under GN yet. If they don't,
volunteer to help convert them!
-_17 Nov 2014. We are updating the stuff we use to track progress. Watch
-this space and chromium-dev@ for more info!_.
+Or, look at [the list of open bugs](https://code.google.com/p/chromium/issues/list?can=2&q=label:Proj-GN-Migration%20-type:Project&sort=pri&colspec=ID%20Pri%20Summary%20Type%20OS%20Owner%20Status%20Modified%20Blocking) related to the migration and see if there's anything that catches your fancy.
## I want more info on GN!
Read these links:
- * [Quick start](docs/quick_start.md)
- * [FAQ](docs/faq.md)
- * [GYP conversion cookbook](docs/cookbook.md)
- * [Language and operation details](docs/language.md)
- * [Reference](docs/reference.md) The built-in `gn help` documentation.
- * [Style guide](docs/style_guide.md)
- * [Cross compiling and toolchains](docs/cross_compiles.md)
- * [Hacking on GN itself](docs/hacking.md)
- * [GNStandalone](docs/standalone.md) Standalone GN projects
- * [UpdateGNBinaries](docs/update_binaries.md) Pushing new binaries
- * [Check](docs/check.md) `gn check` command reference
+ * [Quick start](/chromium/src/+/master/tools/gn/docs/quick_start.md)
+ * [FAQ](/chromium/src/+/master/tools/gn/docs/faq.md)
+ * [GYP conversion cookbook](/chromium/src/+/master/tools/gn/docs/cookbook.md)
+ * [Language and operation details](/chromium/src/+/master/tools/gn/docs/language.md)
+ * [Reference](/chromium/src/+/master/tools/gn/docs/reference.md) The built-in `gn help` documentation.
+ * [Style guide](/chromium/src/+/master/tools/gn/docs/style_guide.md)
+ * [Cross compiling and toolchains](/chromium/src/+/master/tools/gn/docs/cross_compiles.md)
+ * [Hacking on GN itself](/chromium/src/+/master/tools/gn/docs/hacking.md)
+ * [GNStandalone](/chromium/src/+/master/tools/gn/docs/standalone.md) Standalone GN projects
+ * [UpdateGNBinaries](/chromium/src/+/master/tools/gn/docs/update_binaries.md) Pushing new binaries
+ * [Check](/chromium/src/+/master/tools/gn/docs/check.md) `gn check` command reference
« no previous file with comments | « no previous file | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698