Git development
 help / color / mirror / Atom feed
From: Sergey Vlasov <vsu@altlinux.ru>
To: Junio C Hamano <junkio@cox.net>
Cc: git@vger.kernel.org
Subject: [PATCH 0/2] Improve man pages formatting
Date: Mon, 19 Sep 2005 14:09:14 +0400	[thread overview]
Message-ID: <20050919100914.GA28095@master.mivlgu.local> (raw)

[-- Attachment #1: Type: text/plain, Size: 585 bytes --]

Hello!

Currently GIT man pages - especially git(7) - do not look good,
because the references to other man pages are represented as HTML file
names (like "git-cat-file: git-cat-file.html").  The standard
convention for such references in man pages is PAGE(SECTION), and some
man viewers (e.g., pinfo (pman), or KDE help) even treat such text in
man pages as hyperlinks.

This problem was fixed in cogito by adding the "gitlink:" asciidoc
macro which generates proper formatting for either HTML or man page
output.  I have adapted that patch for GIT.

-- 
Sergey Vlasov

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

             reply	other threads:[~2005-09-19 10:09 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2005-09-19 10:09 Sergey Vlasov [this message]
2005-09-19 10:10 ` [PATCH 1/2] Documentation: Add asciidoc.conf file and gitlink: macro Sergey Vlasov
2005-09-19 10:10 ` [PATCH 2/2] Documentation: Update all files to use the new " Sergey Vlasov

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20050919100914.GA28095@master.mivlgu.local \
    --to=vsu@altlinux.ru \
    --cc=git@vger.kernel.org \
    --cc=junkio@cox.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox