On Thu, May 25, 2023 at 07:17:52 -0400, Greg Troxel wrote: > Jan Schaumann <jscha...@netmeister.org> writes: > > > Valery Ushakov <u...@stderr.spb.ru> 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