Re: CVS commit: src/usr.bin/chflags

[Valery Ushakov <uwe%stderr.spb.ru@localhost>]

On Thu, May 25, 2023 at 07:17:52 -0400, Greg Troxel wrote:

> Jan Schaumann <jschauma%netmeister.org@localhost> writes:
> 
> > Valery Ushakov <uwe%stderr.spb.ru@localhost> wrote:
> >> On Wed, May 24, 2023 at 22:33:17 +0000, Jan Schaumann wrote:
> >
> >> > Briefly describe the 'arch' and 'nodump' flags.
> >> 
> >> What makes them special and why is that these two have to be described
> >> here and not in chflags(2), where the flags are actually defined?
> >
> > Unlike the other flags, they are not intuitive.  As
> > they are exposed to the end-user (versus the
> > programmer), it seems useful to describe them in
> > section 1 of the manual pages.
> 
> FWIW, I agree that the flags are user-facing rather than (only)
> programmer-facing, and thus should be described in a 1/8 manpage vs only
> a 2 manpage.

Then *all* of them should be described in a proper narration.  I'm not
objecting to that.  I'm objecting to sticking the description of two
of them chosen seemingly at random in a place selected seemingly at
random.

Yes, I can see how archive vs dump might be puzzling.  But I still
maintain that the last change made the narration strictly worse
compositionally.

-uwe