Fix multi-paragraph list items in OPTIONS section

This patch makes the html docs right, makes the asciidoc docs a bit odd
but consistent with what is there already, and makes the manpages look
OK using docbook-xsl 1.68, but miss a paragraph separator when using 1.69.

For the manpages, current is like

       -A <author_file>
              Read a file with lines on the form

              username = User's Full Name <email@addr.es>

              and use "User's Full Name <email@addr.es>" as the GIT

With this patch, docbook-xsl v1.68 looks like

       -A <author_file>
              Read a file with lines on the form

                      username = User's Full Name <email@addr.es>

              and use "User's Full Name <email@addr.es>" as the GIT author and

while docbook-xsl v1.69 becomes

       -A <author_file>
              Read a file with lines on the form

                        username = User's Full Name <email@addr.es>
              and use "User's Full Name <email@addr.es>" as the GIT author and

The extra indentation is to keep the v1.69 manpage looking sane.
This commit is contained in:
Francis Daly 2006-03-20 10:41:18 +00:00 committed by Junio C Hamano
parent bb52807916
commit 3070b603ab
2 changed files with 29 additions and 23 deletions

View File

@ -99,18 +99,21 @@ If you need to pass multiple options, separate them with a comma.
CVS by default uses the unix username when writing its CVS by default uses the unix username when writing its
commit logs. Using this option and an author-conv-file commit logs. Using this option and an author-conv-file
in this format in this format
+
---------
exon=Andreas Ericsson <ae@op5.se> exon=Andreas Ericsson <ae@op5.se>
spawn=Simon Pawn <spawn@frog-pond.org> spawn=Simon Pawn <spawn@frog-pond.org>
---------
+
git-cvsimport will make it appear as those authors had git-cvsimport will make it appear as those authors had
their GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL set properly their GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL set properly
all along. all along.
+
For convenience, this data is saved to $GIT_DIR/cvs-authors For convenience, this data is saved to $GIT_DIR/cvs-authors
each time the -A option is provided and read from that same each time the -A option is provided and read from that same
file each time git-cvsimport is run. file each time git-cvsimport is run.
+
It is not recommended to use this feature if you intend to It is not recommended to use this feature if you intend to
export changes back to CVS again later with export changes back to CVS again later with
git-link[1]::git-cvsexportcommit. git-link[1]::git-cvsexportcommit.

View File

@ -75,14 +75,17 @@ When importing incrementally, you might need to edit the .git/svn2git file.
-A <author_file>:: -A <author_file>::
Read a file with lines on the form Read a file with lines on the form
+
------
username = User's Full Name <email@addr.es> username = User's Full Name <email@addr.es>
------
+
and use "User's Full Name <email@addr.es>" as the GIT and use "User's Full Name <email@addr.es>" as the GIT
author and committer for Subversion commits made by author and committer for Subversion commits made by
"username". If encountering a commit made by a user not in the "username". If encountering a commit made by a user not in the
list, abort. list, abort.
+
For convenience, this data is saved to $GIT_DIR/svn-authors For convenience, this data is saved to $GIT_DIR/svn-authors
each time the -A option is provided, and read from that same each time the -A option is provided, and read from that same
file each time git-svnimport is run with an existing GIT file each time git-svnimport is run with an existing GIT