git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH/RFC 0/6] Documentation: use dashless links
@ 2008-09-12 10:55 Michael J Gruber
  2008-09-12 10:55 ` [PATCH/RFC 1/6] modified asciidoc macros for dashless git doc Michael J Gruber
  0 siblings, 1 reply; 8+ messages in thread
From: Michael J Gruber @ 2008-09-12 10:55 UTC (permalink / raw)
  To: git; +Cc: Michael J Gruber

This is yet another attempt at making Junio's eyes sore...
This series implements dashless links in html doc for all commands where
the dashless form is preferred. The idea is to use two different link
macros, such that man pages (from docbook) get the form some viewers
need, whereas html pages get dashless links.

The series is broken down into steps which basically correspond to one
"sed" each, and can thus be checked easily.

Specific R for C:
Do we have a final list of commands which should be advertised in dashed
form? Specifically: What about git-http-{fetch,push}?

To do, after the C in RFC:
Undashify command names in the body of the doc (non-link text).

P.S.: This series corresponds to
ede4caf6e3204f9d63758d6410d0f124b0caab32..29993d99b87b701158d21c8234a162123ee29e39
in the dashless-doc branch of http://repo.or.cz/w/git/mjg.git

P.P.S.: I switched my e-mail address. Sorry about that, I'll stick with
that one.

Michael J Gruber (6):
  modified asciidoc macros for dashless git doc
  convert doc links for server type programmes
  convert doc links for non-dashed git commands
  convert doc links for other pages
  convert doc links for git subcommands
  adjust the command lists (by category) to the new doc link macros

 Documentation/asciidoc.conf              |   19 ++-
 Documentation/blame-options.txt          |    2 +-
 Documentation/cmd-list.perl              |    7 +-
 Documentation/config.txt                 |  174 +++++++++++-----------
 Documentation/diff-options.txt           |    6 +-
 Documentation/everyday.txt               |   48 +++---
 Documentation/fetch-options.txt          |    2 +-
 Documentation/git-add.txt                |   18 +-
 Documentation/git-am.txt                 |   14 +-
 Documentation/git-annotate.txt           |    6 +-
 Documentation/git-apply.txt              |    2 +-
 Documentation/git-archimport.txt         |    2 +-
 Documentation/git-archive.txt            |    2 +-
 Documentation/git-bisect.txt             |    2 +-
 Documentation/git-blame.txt              |    6 +-
 Documentation/git-branch.txt             |    8 +-
 Documentation/git-bundle.txt             |    2 +-
 Documentation/git-cat-file.txt           |    4 +-
 Documentation/git-check-attr.txt         |    4 +-
 Documentation/git-check-ref-format.txt   |    4 +-
 Documentation/git-checkout-index.txt     |    2 +-
 Documentation/git-checkout.txt           |    4 +-
 Documentation/git-cherry-pick.txt        |    4 +-
 Documentation/git-cherry.txt             |    4 +-
 Documentation/git-citool.txt             |    4 +-
 Documentation/git-clean.txt              |    2 +-
 Documentation/git-clone.txt              |    4 +-
 Documentation/git-commit-tree.txt        |    6 +-
 Documentation/git-commit.txt             |   18 +-
 Documentation/git-config.txt             |    2 +-
 Documentation/git-count-objects.txt      |    2 +-
 Documentation/git-cvsexportcommit.txt    |    2 +-
 Documentation/git-cvsimport.txt          |    6 +-
 Documentation/git-cvsserver.txt          |    8 +-
 Documentation/git-daemon.txt             |    2 +-
 Documentation/git-describe.txt           |    2 +-
 Documentation/git-diff-files.txt         |    2 +-
 Documentation/git-diff-index.txt         |    2 +-
 Documentation/git-diff-tree.txt          |    2 +-
 Documentation/git-diff.txt               |    8 +-
 Documentation/git-fast-export.txt        |    6 +-
 Documentation/git-fast-import.txt        |    4 +-
 Documentation/git-fetch-pack.txt         |    2 +-
 Documentation/git-fetch.txt              |    4 +-
 Documentation/git-filter-branch.txt      |    8 +-
 Documentation/git-fmt-merge-msg.txt      |    4 +-
 Documentation/git-format-patch.txt       |    6 +-
 Documentation/git-fsck-objects.txt       |    2 +-
 Documentation/git-fsck.txt               |    2 +-
 Documentation/git-gc.txt                 |   12 +-
 Documentation/git-get-tar-commit-id.txt  |    2 +-
 Documentation/git-grep.txt               |    2 +-
 Documentation/git-gui.txt                |    4 +-
 Documentation/git-hash-object.txt        |    2 +-
 Documentation/git-help.txt               |   10 +-
 Documentation/git-http-fetch.txt         |    2 +-
 Documentation/git-http-push.txt          |    2 +-
 Documentation/git-imap-send.txt          |    2 +-
 Documentation/git-index-pack.txt         |    2 +-
 Documentation/git-init-db.txt            |    2 +-
 Documentation/git-init.txt               |    2 +-
 Documentation/git-instaweb.txt           |    6 +-
 Documentation/git-log.txt                |    4 +-
 Documentation/git-lost-found.txt         |    4 +-
 Documentation/git-ls-files.txt           |   10 +-
 Documentation/git-ls-remote.txt          |    2 +-
 Documentation/git-ls-tree.txt            |    2 +-
 Documentation/git-mailinfo.txt           |    4 +-
 Documentation/git-mailsplit.txt          |    2 +-
 Documentation/git-merge-base.txt         |    2 +-
 Documentation/git-merge-file.txt         |    4 +-
 Documentation/git-merge-index.txt        |    2 +-
 Documentation/git-merge-one-file.txt     |    2 +-
 Documentation/git-merge-tree.txt         |    2 +-
 Documentation/git-merge.txt              |   14 +-
 Documentation/git-mergetool.txt          |    2 +-
 Documentation/git-mktag.txt              |    2 +-
 Documentation/git-mktree.txt             |    2 +-
 Documentation/git-mv.txt                 |    2 +-
 Documentation/git-name-rev.txt           |    2 +-
 Documentation/git-pack-objects.txt       |    8 +-
 Documentation/git-pack-redundant.txt     |    8 +-
 Documentation/git-pack-refs.txt          |    2 +-
 Documentation/git-parse-remote.txt       |    2 +-
 Documentation/git-patch-id.txt           |    2 +-
 Documentation/git-peek-remote.txt        |    2 +-
 Documentation/git-prune-packed.txt       |    6 +-
 Documentation/git-prune.txt              |   10 +-
 Documentation/git-pull.txt               |    8 +-
 Documentation/git-push.txt               |    6 +-
 Documentation/git-quiltimport.txt        |    2 +-
 Documentation/git-read-tree.txt          |    8 +-
 Documentation/git-rebase.txt             |    4 +-
 Documentation/git-receive-pack.txt       |    6 +-
 Documentation/git-reflog.txt             |    8 +-
 Documentation/git-relink.txt             |    2 +-
 Documentation/git-remote.txt             |   12 +-
 Documentation/git-repack.txt             |   16 +-
 Documentation/git-repo-config.txt        |    2 +-
 Documentation/git-request-pull.txt       |    2 +-
 Documentation/git-rerere.txt             |    2 +-
 Documentation/git-reset.txt              |    6 +-
 Documentation/git-rev-list.txt           |    2 +-
 Documentation/git-rev-parse.txt          |    4 +-
 Documentation/git-revert.txt             |    8 +-
 Documentation/git-rm.txt                 |    4 +-
 Documentation/git-send-email.txt         |    2 +-
 Documentation/git-send-pack.txt          |    6 +-
 Documentation/git-sh-setup.txt           |    2 +-
 Documentation/git-shell.txt              |    2 +-
 Documentation/git-shortlog.txt           |    2 +-
 Documentation/git-show-branch.txt        |    4 +-
 Documentation/git-show-index.txt         |    2 +-
 Documentation/git-show-ref.txt           |    4 +-
 Documentation/git-show.txt               |    4 +-
 Documentation/git-stash.txt              |   12 +-
 Documentation/git-status.txt             |    8 +-
 Documentation/git-stripspace.txt         |    2 +-
 Documentation/git-submodule.txt          |    4 +-
 Documentation/git-svn.txt                |    8 +-
 Documentation/git-symbolic-ref.txt       |    2 +-
 Documentation/git-tag.txt                |    2 +-
 Documentation/git-tar-tree.txt           |    2 +-
 Documentation/git-unpack-file.txt        |    2 +-
 Documentation/git-unpack-objects.txt     |    4 +-
 Documentation/git-update-index.txt       |   14 +-
 Documentation/git-update-ref.txt         |    2 +-
 Documentation/git-update-server-info.txt |    4 +-
 Documentation/git-upload-archive.txt     |    2 +-
 Documentation/git-upload-pack.txt        |    2 +-
 Documentation/git-var.txt                |    8 +-
 Documentation/git-verify-pack.txt        |    2 +-
 Documentation/git-verify-tag.txt         |    2 +-
 Documentation/git-web--browse.txt        |    4 +-
 Documentation/git-whatchanged.txt        |    2 +-
 Documentation/git-write-tree.txt         |    2 +-
 Documentation/git.txt                    |   40 +++---
 Documentation/gitattributes.txt          |   10 +-
 Documentation/gitcli.txt                 |    2 +-
 Documentation/gitcore-tutorial.txt       |   16 +-
 Documentation/gitcvs-migration.txt       |   24 ++--
 Documentation/gitdiffcore.txt            |   16 +-
 Documentation/gitglossary.txt            |    6 +-
 Documentation/githooks.txt               |    2 +-
 Documentation/gitignore.txt              |    2 +-
 Documentation/gitk.txt                   |    6 +-
 Documentation/gitmodules.txt             |    6 +-
 Documentation/gitrepository-layout.txt   |   30 ++--
 Documentation/gittutorial-2.txt          |   22 ++--
 Documentation/gittutorial.txt            |   28 ++--
 Documentation/glossary-content.txt       |   18 +-
 Documentation/merge-config.txt           |    8 +-
 Documentation/pretty-options.txt         |    2 +-
 Documentation/rev-list-options.txt       |   14 +-
 Documentation/urls-remotes.txt           |    2 +-
 Documentation/urls.txt                   |    2 +-
 Documentation/user-manual.txt            |  246 +++++++++++++++---------------
 command-list.txt                         |   12 +-
 158 files changed, 680 insertions(+), 664 deletions(-)

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

end of thread, other threads:[~2008-09-12 11:33 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-09-12 10:55 [PATCH/RFC 0/6] Documentation: use dashless links Michael J Gruber
2008-09-12 10:55 ` [PATCH/RFC 1/6] modified asciidoc macros for dashless git doc Michael J Gruber
2008-09-12 10:55   ` [PATCH/RFC 2/6] convert doc links for server type programmes from linkgit to gitlink Michael J Gruber
2008-09-12 10:55     ` [PATCH/RFC 2/6] convert doc links for server type programmes Michael J Gruber
2008-09-12 10:55       ` [PATCH/RFC 3/6] convert doc links for non-dashed git commands Michael J Gruber
2008-09-12 10:55         ` [PATCH/RFC 4/6] convert doc links for other pages Michael J Gruber
     [not found]           ` <1221216926-20435-7-git-send-email-git@drmicha.warpmail.net>
2008-09-12 10:55             ` [PATCH/RFC 6/6] adjust the command lists (by category) to the new doc link macros Michael J Gruber
2008-09-12 11:32     ` [PATCH/RFC 2/6] convert doc links for server type programmes from linkgit to gitlink Michael J Gruber

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).