On Mon, Apr 06, 2009 at 02:56:52PM +1000, Allan McRae wrote:

Loui Chang wrote:

...

Signed-off-by: Loui Chang <louipc.ist@gmail.com> --- doc/PKGBUILD.5.txt | 14 +++++++------- doc/makepkg.8.txt | 2 +- doc/repo-add.8.txt | 8 +------- 3 files changed, 9 insertions(+), 15 deletions(-)

This patch along with an asciidoc patch (http://hg.sharesource.org/asciidoc/rev/1dfa7028bbb3) remove all warnings for me and I notice no problem with man pages afterwards.

...

diff --git a/doc/PKGBUILD.5.txt b/doc/PKGBUILD.5.txt index f8ed7f2..9e271af 100644 --- a/doc/PKGBUILD.5.txt +++ b/doc/PKGBUILD.5.txt @@ -65,19 +65,19 @@ similar to `$_basekernver`. This field specifies the license(s) that apply to the package. Commonly-used licenses are found in '/usr/share/licenses/common'. If you see the package's license there, simply reference it in the license - field (e.g. `$$license=('GPL')$$`). If the package provides a license not + field (e.g. $$license=('GPL')$$). If the package provides a license not

What were the back-ticks attempting to do in these cases? Are we losing anything?

I think they were meant to make the text monospaced. I guess this change does have an effect outside the standard console environment. Here's a reference: http://www.methods.co.nz/asciidoc/userguide.html#X77

<snip>

...

Name ---- -//// -* If we use this below line, the manpage name comes out all weird. We also -* can't use two separate lines, which is quite annoying. * -repo-add, repo-remove - package database maintenance utilities -//// -repo-add - package database maintenance utility - +repo-add - repo-remove - package database maintenance utilities

This looks a bit strange with the dash separating repo-add and repo-remove. Most other man pages for multiple things use commas to separate the names then a dash before the description. It would be good to be consistent...

I think it looks fine. The problem is that asciidoc will want to create a manpage called repo-add,_repo-remove.8. So this is better than totally omitting repo-remove from that description I think.