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

Re: Git documentation at kernel.org

From
Jeff King <peff@peff.net>
Date
Feb 10, 2012, 20:01 UTC
Message-ID
<20120210200100.GA5504@sigill.intra.peff.net>
In-Reply-To
<1328900154.3171.27.camel@i5.mricon.com>
On Fri, Feb 10, 2012 at 01:55:54PM -0500, Konstantin Ryabitsev wrote:
Show 12 quoted lines
> I have a few comments off the top of my head:
> 
>      1. "kup rm" will need to be modified, as it currently only allows
>         deleting things that have a matching signature. The alternative
>         is for UNPACK to create a foo.tar.manifest file that will be
>         consulted upon "kup rm" to clean up any unpacked contents upon
>         the deletion of the source archive. Note, that there are many,
>         many gotchas with this solution -- e.g. .manifest should
>         probably contain checksums, too, as there are bound to be
>         conditions when two tarballs reference the same files, and you
>         want to make sure that you delete files matching the contents of
>         the old tarball, not the newer one, etc.

For this particular use case, I don't know if that would be necessary. According to Junio, previously:

  The k.org site kept these files under /pub/software/scm/git/docs/. The
  in-development "master" version of pages were placed directly
  underneath that directory, and the documentation pages for older
  versions were kept in vX.Y.Z subdirectory of that directory.

If we tweak that slightly to "all versions are kept in vX.Y.Z subdirectory, and the root version is simply a symlink or redirect to the latest vX.Y.Z", then there is no deletion required. The pusher is always adding new versions, and updating a link[1].

But even if it would be sufficient for this use case, kup developers may not want such a half-implemented scheme in their protocol.

-Peff
[1] There is a slight complication that the subdirectories live _inside_
    of the root directory, so it is not implementable with a single
    symlink.  You could get around that with a few clever http redirects.
Previous: Junio C HamanoNext: Junio C Hamano
Message 11 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.