Migrate content from wiki

Migrate content from wiki.

The wiki existed at https://code.google.com/p/crashpad/wiki, but given
Google Code Project Hosting’s impending shutdown[1], it’s prudent to
move wiki documents into the source code repository.

This change moves the existing contents of doc into doc/support, to make
way for documentation in doc. The two existing wiki pages, ProjectStatus
and DevelopingCrashpad, are converted to AsciiDoc format (a fairly
straightforward conversion) and checked in to doc. generate_asciidoc.sh
is updated to produce HTML output from these files. The generated HTML
will show up at http://docs.crashpad.googlecode.com/git/doc/. Note that
generated HTML is still hosted on Google Code Project Hosting, but it’ll
be easy to find a new home for them.

[1]
http://google-opensource.blogspot.com/2015/03/farewell-to-google-code.html

R=rsesek@chromium.org

Committed: https://chromium.googlesource.com/crashpad/crashpad/+/332e8219ed9cdcecc587c31241caa94ed9c12c02

[Mark Mentovai, 2015-04-01 14:36:23]

mark@chromium.org changed reviewers:
+ rsesek@chromium.org

[Robert Sesek, 2015-04-01 15:25:58]

LGTM

https://codereview.chromium.org/1055523002/diff/40001/doc/developing.ad
File doc/developing.ad (right):

https://codereview.chromium.org/1055523002/diff/40001/doc/developing.ad#newco...
doc/developing.ad:189: $ git cl land -c 'External Contributor
<\external@contributor.org>'
Is this \ in the right place?

https://codereview.chromium.org/1055523002/diff/40001/doc/support/asciidoc.conf
File doc/support/asciidoc.conf (right):

https://codereview.chromium.org/1055523002/diff/40001/doc/support/asciidoc.co...
doc/support/asciidoc.conf:33: Version {revnumber}{basebackend-xhtml11?<br
/>}{basebackend-xhtml11=<br>}
If asciidoc supports it, HTML 5 > XHTML 1.1.

[Mark Mentovai, 2015-04-01 16:10:00]

https://codereview.chromium.org/1055523002/diff/40001/doc/developing.ad
File doc/developing.ad (right):

https://codereview.chromium.org/1055523002/diff/40001/doc/developing.ad#newco...
doc/developing.ad:189: $ git cl land -c 'External Contributor
<\external@contributor.org>'
Robert Sesek wrote:
> Is this \ in the right place?

Yeah, it’s needed to keep asciidoc from auto-linking the address.

But I changed this a little bit to match the man pages, where the things that
you’re supposed to type are rendered in boldface. Since I got rid of
“subs=macros”, the backslash on the address was no longer necessary, but adding
“subs=quotes” meant that a few other things need backslashes.

https://codereview.chromium.org/1055523002/diff/40001/doc/support/asciidoc.conf
File doc/support/asciidoc.conf (right):

https://codereview.chromium.org/1055523002/diff/40001/doc/support/asciidoc.co...
doc/support/asciidoc.conf:33: Version {revnumber}{basebackend-xhtml11?<br
/>}{basebackend-xhtml11=<br>}
Robert Sesek wrote:
> If asciidoc supports it, HTML 5 > XHTML 1.1.

We do tell it to generate HTML 5 in doc/support/generate_asciidoc.sh (--backend
html5).

Unlike XHTML, HTML 5 permits <br> without the trailing slash, so <br> isn’t
incorrect. http://dev.w3.org/html5/html-author/#void

I wouldn’t mind changing it to <br/> but am going to leave it alone because this
is just a modification of the footer-text template that comes from the default
asciidoc lang-en.conf, which is:

[footer-text]
Version {revnumber}{basebackend-xhtml11?<br />}{basebackend-xhtml11=<br>}
Last updated {docdate} {doctime}

so I’m using the Version line as-is for non-manpage docs, which has the effect
of not showing a Version line at all, because we’re not giving asciidoc a
revnumber attribute.

https://codereview.chromium.org/1055523002/diff/60001/tools/crashpad_database...
File tools/crashpad_database_util.ad (left):

https://codereview.chromium.org/1055523002/diff/60001/tools/crashpad_database...
tools/crashpad_database_util.ad:151: include::../../doc/man_footer.ad[]
Oops, this wasn’t the right path before.

[Mark Mentovai, 2015-04-01 16:39:58]

Committed patchset #4 (id:60001) manually as
332e8219ed9cdcecc587c31241caa94ed9c12c02 (presubmit successful).

[Mark Mentovai, 2015-04-01 16:43:54]

The generated documentation is checked in at
http://docs.crashpad.googlecode.com/git/doc/.