Git development
 help / color / mirror / Atom feed
* [PATCH 0/2] Improve man pages formatting
@ 2005-09-19 10:09 Sergey Vlasov
  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
  0 siblings, 2 replies; 3+ messages in thread
From: Sergey Vlasov @ 2005-09-19 10:09 UTC (permalink / raw)
  To: Junio C Hamano; +Cc: git

[-- 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 --]

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2005-09-19 10:10 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2005-09-19 10:09 [PATCH 0/2] Improve man pages formatting Sergey Vlasov
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

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox