GNU bug report logs - #77974
Manual updates for the VC-aware project backend

Previous Next

Full log

Message #20 received at 77974 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Dmitry Gutov <dmitry <at> gutov.dev>
Cc: 77974 <at> debbugs.gnu.org
Subject: Re: bug#77974: Manual updates for the VC-aware project backend
Date: Fri, 25 Apr 2025 10:23:25 +0300

> Date: Fri, 25 Apr 2025 03:27:29 +0300
> Cc: 77974 <at> debbugs.gnu.org
> From: Dmitry Gutov <dmitry <at> gutov.dev>
> 
> >>> Also, when you introduce new terminology, it is best to use @dfn
> >>> instead of literal quotes, and also have an indexing command for that
> >>> terminology.
> >>
> >> "Untracked" is a fairly common term to the VC subsystem and VC systems
> >> in general.
> > 
> > That's beside the point (you don't explain what it means, presumably
> > because that is known well enough).  The important part is that this
> > is the first (or only) place where it is mentioned in the Emacs
> > manual.
> 
> Okay. Do we provide a definition inline? Or link to another node? Here's 
> what Git says about it:
> 
>    Untracked files in Git are files that exist in your working directory
>    but are not being tracked by Git, meaning they haven't been added to
>    version control.

If you want to explain what "untracked" mean, I think in this case I'd
go with a @footnote, and tell there what you quote from Git, but
without mentioning Git (because I believe all VCSes handle untracked
files the same).

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.