From: Drew Northup <drew.northup@maine.edu>
Date: Tue, 11 Oct 2011 13:02:15 GMT
Subject: Re: [PATCHv5/RFC 3/6] gitweb: Add manpage for gitweb
Message-ID: <1318338135.22324.33.camel@drew-northup.unet.maine.edu>
In-Reply-To: <20111010221811.GA21367@elie.hsd1.il.comcast.net>

On Mon, 2011-10-10 at 17:18 -0500, Jonathan Nieder wrote:
> Jakub Narebski wrote:
> 
> > The problem is that catering to old AsciiDoc (but still used by some of
> > long-term-support Linux distributions) requires to have "SYNOPSIS"
> > section... but there is no natural synopsis for non self-hostable web
> > application, is there?
> 
> I personally think something like
> 
> 	SYNOPSIS
> 	--------
> 	/usr/share/gitweb/gitweb.cgi
> 	git instaweb
> 
> or perhaps something like
> 
> 	SYNOPSIS
> 	--------
> 	http://<site>/?p=<project>.git;a=<action>;h=<object>;<parameters>
> 	http://<site>/<project>/<action>/<object>?<parameters>
> 
> would be best.

This would be why I included a synopsis with my original submission. As
this was supposed to be a description of the configuration files of said
application it does not make much sense to put the executable in the
synopsis. Please forgive me for attempting to make sense!

-- 
-Drew Northup
________________________________________________
"As opposed to vegetable or mineral error?"
-John Pescatore, SANS NewsBites Vol. 12 Num. 59