Re: [PATCH] git.txt: Fix asciidoc syntax of --*-pathspecs

2013-10-15 Thread Junio C Hamano 
Steffen Prohaska proha...@zib.de writes:

 Labeled lists require a double colon.

 Signed-off-by: Steffen Prohaska proha...@zib.de
 ---

Looks sensible; it would have been nicer if the log message said
something like

I eyeballed the output from

git grep '[^:]:$' Documentation/\*.txt

and these are the only breakages of this kind

(which I did just now).

  Documentation/git.txt | 6 +++---
  1 file changed, 3 insertions(+), 3 deletions(-)

 diff --git a/Documentation/git.txt b/Documentation/git.txt
 index 5d68d33..4c2757e 100644
 --- a/Documentation/git.txt
 +++ b/Documentation/git.txt
 @@ -475,19 +475,19 @@ example the following invocations are equivalent:
   This is equivalent to setting the `GIT_LITERAL_PATHSPECS` environment
   variable to `1`.
  
 ---glob-pathspecs:
 +--glob-pathspecs::
   Add glob magic to all pathspec. This is equivalent to setting
   the `GIT_GLOB_PATHSPECS` environment variable to `1`. Disabling
   globbing on individual pathspecs can be done using pathspec
   magic :(literal)
  
 ---noglob-pathspecs:
 +--noglob-pathspecs::
   Add literal magic to all pathspec. This is equivalent to setting
   the `GIT_NOGLOB_PATHSPECS` environment variable to `1`. Enabling
   globbing on individual pathspecs can be done using pathspec
   magic :(glob)
  
 ---icase-pathspecs:
 +--icase-pathspecs::
   Add icase magic to all pathspec. This is equivalent to setting
   the `GIT_ICASE_PATHSPECS` environment variable to `1`.
--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] git.txt: Fix asciidoc syntax of --*-pathspecs

2013-09-23 Thread Steffen Prohaska 
Labeled lists require a double colon.

Signed-off-by: Steffen Prohaska proha...@zib.de
---
 Documentation/git.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Documentation/git.txt b/Documentation/git.txt
index 5d68d33..4c2757e 100644
--- a/Documentation/git.txt
+++ b/Documentation/git.txt
@@ -475,19 +475,19 @@ example the following invocations are equivalent:
This is equivalent to setting the `GIT_LITERAL_PATHSPECS` environment
variable to `1`.
 
---glob-pathspecs:
+--glob-pathspecs::
Add glob magic to all pathspec. This is equivalent to setting
the `GIT_GLOB_PATHSPECS` environment variable to `1`. Disabling
globbing on individual pathspecs can be done using pathspec
magic :(literal)
 
---noglob-pathspecs:
+--noglob-pathspecs::
Add literal magic to all pathspec. This is equivalent to setting
the `GIT_NOGLOB_PATHSPECS` environment variable to `1`. Enabling
globbing on individual pathspecs can be done using pathspec
magic :(glob)
 
---icase-pathspecs:
+--icase-pathspecs::
Add icase magic to all pathspec. This is equivalent to setting
the `GIT_ICASE_PATHSPECS` environment variable to `1`.
 
-- 
1.8.4.477.gfa286b2

--
To unsubscribe from this list: send the line unsubscribe git in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] git.txt: Fix asciidoc syntax of --*-pathspecs

2013-09-23 Thread Jeff King 
On Mon, Sep 23, 2013 at 08:54:35PM +0200, Steffen Prohaska wrote:

 Labeled lists require a double colon.

Thanks, this looks good.

While looking at the git.txt source, I noticed it is quite awkward to
read due to the size of the stalenotes section. The patch below moves
that section out to its own file.

That section used to be turned on when Junio auto-built the
documentation after pushing to kernel.org. But he does not seem to do so
for recent versions of the auto-generated docs, as of commit adaa3ca on
the 'todo' branch. I don't know if that is a bug, or if the whole
stalenotes thing can simply go away.

-- 8 --
Subject: [PATCH] docs: split stalenotes out from git.txt

The git.txt manpage contains a section indicating the
current version, and pointing to release notes for past
versions. We don't usually include this version in the built
manpages, but anyone looking at the source needs to scroll
past it. Let's make it easier on them by splitting it out
into its own file.

Signed-off-by: Jeff King p...@peff.net
---
 Documentation/git.txt| 345 +--
 Documentation/stalenotes.txt | 344 ++
 2 files changed, 345 insertions(+), 344 deletions(-)
 create mode 100644 Documentation/stalenotes.txt

diff --git a/Documentation/git.txt b/Documentation/git.txt
index 5d68d33..3d99668 100644
--- a/Documentation/git.txt
+++ b/Documentation/git.txt
@@ -34,350 +34,7 @@ can be viewed at 
`http://git-htmldocs.googlecode.com/git/git.html`.
 Formatted and hyperlinked version of the latest Git documentation
 can be viewed at `http://git-htmldocs.googlecode.com/git/git.html`.
 
-ifdef::stalenotes[]
-[NOTE]
-
-
-You are reading the documentation for the latest (possibly
-unreleased) version of Git, that is available from 'master'
-branch of the `git.git` repository.
-Documentation for older releases are available here:
-
-* link:v1.8.4/git.html[documentation for release 1.8.4]
-
-* release notes for
-  link:RelNotes/1.8.4.txt[1.8.4].
-
-* link:v1.8.3.4/git.html[documentation for release 1.8.3.4]
-
-* release notes for
-  link:RelNotes/1.8.3.4.txt[1.8.3.4],
-  link:RelNotes/1.8.3.3.txt[1.8.3.3],
-  link:RelNotes/1.8.3.2.txt[1.8.3.2],
-  link:RelNotes/1.8.3.1.txt[1.8.3.1],
-  link:RelNotes/1.8.3.txt[1.8.3].
-
-* link:v1.8.2.3/git.html[documentation for release 1.8.2.3]
-
-* release notes for
-  link:RelNotes/1.8.2.3.txt[1.8.2.3],
-  link:RelNotes/1.8.2.2.txt[1.8.2.2],
-  link:RelNotes/1.8.2.1.txt[1.8.2.1],
-  link:RelNotes/1.8.2.txt[1.8.2].
-
-* link:v1.8.1.6/git.html[documentation for release 1.8.1.6]
-
-* release notes for
-  link:RelNotes/1.8.1.6.txt[1.8.1.6],
-  link:RelNotes/1.8.1.5.txt[1.8.1.5],
-  link:RelNotes/1.8.1.4.txt[1.8.1.4],
-  link:RelNotes/1.8.1.3.txt[1.8.1.3],
-  link:RelNotes/1.8.1.2.txt[1.8.1.2],
-  link:RelNotes/1.8.1.1.txt[1.8.1.1],
-  link:RelNotes/1.8.1.txt[1.8.1].
-
-* link:v1.8.0.3/git.html[documentation for release 1.8.0.3]
-
-* release notes for
-  link:RelNotes/1.8.0.3.txt[1.8.0.3],
-  link:RelNotes/1.8.0.2.txt[1.8.0.2],
-  link:RelNotes/1.8.0.1.txt[1.8.0.1],
-  link:RelNotes/1.8.0.txt[1.8.0].
-
-* link:v1.7.12.4/git.html[documentation for release 1.7.12.4]
-
-* release notes for
-  link:RelNotes/1.7.12.4.txt[1.7.12.4],
-  link:RelNotes/1.7.12.3.txt[1.7.12.3],
-  link:RelNotes/1.7.12.2.txt[1.7.12.2],
-  link:RelNotes/1.7.12.1.txt[1.7.12.1],
-  link:RelNotes/1.7.12.txt[1.7.12].
-
-* link:v1.7.11.7/git.html[documentation for release 1.7.11.7]
-
-* release notes for
-  link:RelNotes/1.7.11.7.txt[1.7.11.7],
-  link:RelNotes/1.7.11.6.txt[1.7.11.6],
-  link:RelNotes/1.7.11.5.txt[1.7.11.5],
-  link:RelNotes/1.7.11.4.txt[1.7.11.4],
-  link:RelNotes/1.7.11.3.txt[1.7.11.3],
-  link:RelNotes/1.7.11.2.txt[1.7.11.2],
-  link:RelNotes/1.7.11.1.txt[1.7.11.1],
-  link:RelNotes/1.7.11.txt[1.7.11].
-
-* link:v1.7.10.5/git.html[documentation for release 1.7.10.5]
-
-* release notes for
-  link:RelNotes/1.7.10.5.txt[1.7.10.5],
-  link:RelNotes/1.7.10.4.txt[1.7.10.4],
-  link:RelNotes/1.7.10.3.txt[1.7.10.3],
-  link:RelNotes/1.7.10.2.txt[1.7.10.2],
-  link:RelNotes/1.7.10.1.txt[1.7.10.1],
-  link:RelNotes/1.7.10.txt[1.7.10].
-
-* link:v1.7.9.7/git.html[documentation for release 1.7.9.7]
-
-* release notes for
-  link:RelNotes/1.7.9.7.txt[1.7.9.7],
-  link:RelNotes/1.7.9.6.txt[1.7.9.6],
-  link:RelNotes/1.7.9.5.txt[1.7.9.5],
-  link:RelNotes/1.7.9.4.txt[1.7.9.4],
-  link:RelNotes/1.7.9.3.txt[1.7.9.3],
-  link:RelNotes/1.7.9.2.txt[1.7.9.2],
-  link:RelNotes/1.7.9.1.txt[1.7.9.1],
-  link:RelNotes/1.7.9.txt[1.7.9].
-
-* link:v1.7.8.6/git.html[documentation for release 1.7.8.6]
-
-* release notes for
-  link:RelNotes/1.7.8.6.txt[1.7.8.6],
-  link:RelNotes/1.7.8.5.txt[1.7.8.5],
-  link:RelNotes/1.7.8.4.txt[1.7.8.4],
-  link:RelNotes/1.7.8.3.txt[1.7.8.3],
-  link:RelNotes/1.7.8.2.txt[1.7.8.2],
-  link:RelNotes/1.7.8.1.txt[1.7.8.1],
-  link:RelNotes/1.7.8.txt[1.7.8].
-
-* link:v1.7.7.7/git.html[documentation for release 1.7.7.7]
-
-*