git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] Rename {git- => git}remote-helpers.txt

From
Junio C Hamano <gitster@pobox.com>
Date
Jan 31, 2013, 22:43 UTC
Message-ID
<7vtxpxdldj.fsf@alter.siamese.dyndns.org>
In-Reply-To
<20130131222817.GP1342@serenity.lan>
John Keeping <john@keeping.me.uk> writes:
> Yes.  Should I change it to "git-remote-helpers.html.in" and then copy
> it into place?  That seems like the simplest answer and means that
> "*.html" will continue to refer only to generated files.

I'd like to see if we can have a way to keep its look as the default css gets updated without maintainance burden.

How about using AsciiDoc instead of "cp", perhaps like this on top of your patch?

 Documentation/.gitignore              |  1 -
 Documentation/Makefile                |  9 +++++-
 Documentation/git-remote-helpers.txto | 26 +++++++++++++++++
 Documentation/git-remote-helpers.html | 55 -----------------------------------
 4 files changed, 34 insertions(+), 57 deletions(-)
diff --git a/Documentation/.gitignore b/Documentation/.gitignore
index 4685378..d62aebd 100644
--- a/Documentation/.gitignore
+++ b/Documentation/.gitignore
@@ -1,6 +1,5 @@
 *.xml
 *.html
-!git-remote-helpers.html
 *.[1-8]
 *.made
 *.texi
diff --git a/Documentation/Makefile b/Documentation/Makefile
index 13e0098..fa2f9f9 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -13,7 +13,8 @@ MAN_TXT = $(MAN1_TXT) $(MAN5_TXT) $(MAN7_TXT)
 MAN_XML=$(patsubst %.txt,%.xml,$(MAN_TXT))
 MAN_HTML=$(patsubst %.txt,%.html,$(MAN_TXT))
 
-DOC_HTML=$(MAN_HTML) git-remote-helpers.html
+OBSOLETE_HTML = git-remote-helpers.html
+DOC_HTML=$(MAN_HTML) $(OBSOLETE_HTML)
 
 ARTICLES = howto-index
 ARTICLES += everyday
@@ -261,6 +262,12 @@ $(MAN_HTML): %.html : %.txt asciidoc.conf
 		$(ASCIIDOC_EXTRA) -agit_version=$(GIT_VERSION) -o $@+ $< && \
 	mv $@+ $@
 
+$(OBSOLETE_HTML): %.html : %.txto asciidoc.conf
+	$(QUIET_ASCIIDOC)$(RM) $@+ $@ && \
+	$(ASCIIDOC) -b xhtml11 -d manpage -f asciidoc.conf \
+		$(ASCIIDOC_EXTRA) -agit_version=$(GIT_VERSION) -o $@+ $< && \
+	mv $@+ $@
+
 manpage-base-url.xsl: manpage-base-url.xsl.in
 	sed "s|@@MAN_BASE_URL@@|$(MAN_BASE_URL)|" $< > $@
 
diff --git a/Documentation/git-remote-helpers.txto b/Documentation/git-remote-helpers.txto
new file mode 100644
index 0000000..a966013
--- /dev/null
+++ b/Documentation/git-remote-helpers.txto
@@ -0,0 +1,25 @@
+git-remote-helpers(1)
+=====================
+
+NAME
+----
+git-remote-helpers - obsoleted page
+
+SYNOPSIS
+--------
+See linkgit:gitremote-helpers[1].
+
+DESCRIPTION
+-----------
+This document has been moved to linkgit:gitremote-helpers[1].
+
+Please let the owners of the referring site know so that they can update the
+link you clicked to get here.
+
+SEE ALSO
+--------
+linkgit:gitremote-helpers[1]
+
+GIT
+---
+No longer a part of the linkgit:git[1] suite
diff --git a/Documentation/git-remote-helpers.html b/Documentation/git-remote-helpers.html
deleted file mode 100644
index 0c5ec27..0000000
--- a/Documentation/git-remote-helpers.html
+++ /dev/null
@@ -1,55 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
-    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
-<head>
-<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
-<title>git-remote-helpers(1) - Document Moved</title>
-<style type="text/css">
-/* Cut-down styles from asciidoc.css. */
-
-/* Default font. */
-body {
-  font-family: Georgia,serif;
-}
-
-/* Title font. */
-h1 {
-  font-family: Arial,Helvetica,sans-serif;
-}
-
-body {
-  margin: 1em 5% 1em 5%;
-}
-
-a {
-  color: blue;
-  text-decoration: underline;
-}
-a:visited {
-  color: fuchsia;
-}
-
-h1, h2, h3, h4, h5, h6 {
-  color: #527bbd;
-  margin-top: 1.2em;
-  margin-bottom: 0.5em;
-  line-height: 1.3;
-}
-
-</style>
-</head>
-<body class="manpage">
-<div id="header">
-<h1>
-Document Moved
-</h1>
-</div>
-
-<p>This document is now called <a
-href="gitremote-helpers.html">gitremote-helpers</a>.</p>
-
-<p>Please let the owners of the referring site know so that they can update the
-link you clicked to get here.</p>
-
-</body>
-</html>
Previous: John KeepingNext: John Keeping
Message 9 of 32 in “git-remote-helpers.txt: should it be gitremote-helpers.txt?”
  1. John KeepingJan 30, 2013
  2. Junio C HamanoJan 30, 2013
  3. gitremote-helpers.txt: rename from git-remote-helpers.txtJohn Keeping, Jan 31, 2013
  4. Matthieu MoyJan 31, 2013
  5. Junio C HamanoJan 31, 2013
  6. Rename {git- => git}remote-helpers.txtJohn Keeping, Jan 31, 2013
  7. Junio C HamanoJan 31, 2013
  8. John KeepingJan 31, 2013
  9. Junio C HamanoJan 31, 2013
  10. John KeepingJan 31, 2013
  11. Junio C HamanoJan 31, 2013
  12. Jeff KingJan 31, 2013
  13. Junio C HamanoJan 31, 2013
  14. Jonathan NiederJan 31, 2013
  15. Junio C HamanoJan 31, 2013
  16. Jonathan NiederJan 31, 2013
  17. Jeff KingFeb 1, 2013
  18. Junio C HamanoFeb 1, 2013
  19. Jeff KingFeb 1, 2013
  20. Jeff KingFeb 1, 2013
  21. 1/2 Documentation/Makefile: clean up MAN*_TXT listsJeff King, Feb 1, 2013
  22. Jonathan NiederFeb 1, 2013
  23. Junio C HamanoFeb 1, 2013
  24. Jeff KingFeb 1, 2013
  25. Jeff KingFeb 1, 2013
  26. 2/2 docs: convert "concept" manpages to git-*Jeff King, Feb 1, 2013
  27. Jonathan NiederFeb 1, 2013
  28. Junio C HamanoFeb 1, 2013
  29. Jeff KingFeb 1, 2013
  30. Junio C HamanoFeb 1, 2013
  31. Tomas CarneckyJan 31, 2013
  32. Junio C HamanoJan 31, 2013

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.