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

Re: Git documentation at kernel.org

From
Junio C Hamano <gitster@pobox.com>
Date
Feb 10, 2012, 20:18 UTC
Message-ID
<7vhayyphlw.fsf@alter.siamese.dyndns.org>
In-Reply-To
<20120210195736.GA5381@thunk.org>
Ted Ts'o <tytso@mit.edu> writes:
Show 13 quoted lines
> How about this as something *way* simpler?  Define a way of marking
> the top of a particular directory hierarchy as a tree.  Then the
> *only* way of updating that tree is all or nothing.  That is, someone
> submits a signed tarball; then after the signed tarball has its
> signature checked, it gets unpacked into a dir.new, and then we rename
> dir to dir.old, rename dir.new to dir, and then dir.old gets removed.
>
> That way there's no conflicts between directories that are managed via
> the kup-servers PUT and DELETE commands, and those where they get
> uploaded as a single tarball to create or replace a specific directory
> hierarcy, or which can be deleted only as a entire directory hierarcy.
>
> What do you think?

That would not work very well without changing the historical directory structure (which I think was the point of this discussion "please keep these stale links alive").

The toplevel index.html in the pub/software/scm/git/docs/ directory and its pointees were the set of docs for the latest version, and older versions were rooted at pub/software/scm/git/docs/vX.Y.Z/. Links that point at software/scm/git/docs/git-cat-file.html still need to work, and the path needs to be updatable without having to include the preformatted documentation for all the historical versions in the same tarball.

Previous: Ted Ts'oNext: Ted Ts'o
Message 8 of 21 in “Git documentation at kernel.org”
  1. Petr OnderkaFeb 7, 2012
  2. Clemens BuchacherFeb 8, 2012
  3. Junio C HamanoFeb 10, 2012
  4. Matthieu MoyFeb 10, 2012
  5. Theodore TsoFeb 10, 2012
  6. Konstantin RyabitsevFeb 10, 2012
  7. Ted Ts'oFeb 10, 2012
  8. Junio C HamanoFeb 10, 2012
  9. Ted Ts'oFeb 10, 2012
  10. Junio C HamanoFeb 10, 2012
  11. Jeff KingFeb 10, 2012
  12. Junio C HamanoFeb 10, 2012
  13. Jeff KingFeb 10, 2012
  14. Matthieu MoyFeb 12, 2012
  15. Jeff KingFeb 12, 2012
  16. Scott ChaconFeb 12, 2012
  17. Jeff KingFeb 13, 2012
  18. Junio C HamanoFeb 13, 2012
  19. Jeff KingFeb 14, 2012
  20. Konstantin RyabitsevFeb 13, 2012
  21. Neal KreitzingerFeb 10, 2012

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.