linux: generate a manpage

This is not intended to be complete; hopefully we can iterate from here.

Review URL: http://codereview.chromium.org/159198

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@21277 0039d316-1c4b-4281-b951-d872f2087c98

2 files changed, 90 insertions, 0 deletions

diff --git a/chrome/app/resources/manpage.1.in b/chrome/app/resources/manpage.1.in
new file mode 100644
index 0000000..69ba401
--- /dev/null
+++ b/chrome/app/resources/manpage.1.in
@@ -0,0 +1,60 @@
+.TH @@FILENAME@@ 1 "" "" "USER COMMANDS"
+
+.SH NAME
+@@FILENAME@@ \- the web browser from Google
+
+.SH SYNOPSIS
+.B @@FILENAME@@
+[\fIOPTION\fR] [\fIPATH\fR|\fIURL\fR]
+
+.SH DESCRIPTION
+See the Google Chrome help center for help on using the browser.
+.IP
+http://www.google.com/support/chrome/
+.PP
+This manpage only describes invocation, environment, and arguments.
+
+.SH OPTIONS
+.TP
+\fB\-\-user\-data\-dir\fR=\fIDIR\fR
+Specifies the directory that user data (your "profile") is kept in.
+Defaults to
+.IR ~/.config/@@FILENAME@@/Default .
+Separate instances of @@NAME@@ must use separate user data directories;
+repeated invocations of @@FILENAME@@ will reuse an existing process for
+a given user data directory.
+
+.TP
+\fB\-\-app\fR=\fIURL\fR
+Runs
+.I URL
+in "app mode": with no browser toolbars.
+
+.PP
+As a GTK+ app, @@NAME@@ also obeys GTK+ command-line flags, such
+as
+.BR \-\-display .
+
+See
+<http://library.gnome.org/devel/gtk/stable/gtk-running.html>
+and
+<http://library.gnome.org/devel/gtk/stable/gtk-x11.html> .
+
+.SH ENVIRONMENT
+We obey the
+.B http_proxy
+environment variable for setting the proxy.  This overrides any Gnome
+proxy setting.
+
+TODO(evanm): doc all the proxy-related environment settings.
+
+.SH BUGS
+Our bug tracker:
+.IP
+http://code.google.com/p/chromium/issues/list
+.PP
+Be sure to do your search within "All Issues" before reporting bugs,
+and be sure to pick the "Defect on Linux" template when filing a new one.
+
+.SH AUTHOR
+The Chromium team \- <http://www.chromium.org>
diff --git a/chrome/chrome.gyp b/chrome/chrome.gyp
index 0381a2f..028ff6e 100644
--- a/chrome/chrome.gyp
+++ b/chrome/chrome.gyp
@@ -2694,6 +2694,36 @@
       },
       'conditions': [
         ['OS=="linux"', {
+          'actions': [
+            {
+              'action_name': 'manpage',
+              'conditions': [
+                [ 'branding == "Chrome"', {
+                  'variables': {
+                    'name': 'Google Chrome',
+                    'filename': 'google-chrome',
+                  },
+                }, { # else branding!="Chrome"
+                  'variables': {
+                    'name': 'Chromium',
+                    'filename': 'chromium-browser',
+                  },
+                }],
+              ],
+              'inputs': [
+                'app/resources/manpage.1.in',
+              ],
+              'outputs': [
+                '<(PRODUCT_DIR)/<(filename).1',
+              ],
+              'action': [
+                'sh', '-c',
+                'sed -e "s/@@NAME@@/<(name)/" -e "s/@@FILENAME@@/<(filename)/" app/resources/manpage.1.in > <@(_outputs)',
+              ],
+              'message': 'Generating manpage'
+            },
+          ],
+
           'conditions': [
             # All Chrome builds have breakpad symbols, but only process the
             # symbols from official builds.