On Sun, Feb 09, 2014 at 03:19:36PM -0800, Philip Guenther wrote: > On Sun, Feb 9, 2014 at 3:02 PM, d...@genunix.com <d...@genunix.com> wrote: > > Question .. where do I get all the man pages? I have some of them > > but then others are absent : > > > > > > # man reboot > > REBOOT(8) OpenBSD System Manager's Manual > > REBOOT(8) > ... > > SEE ALSO > > reboot(2), utmp(5), boot_alpha(8), boot_amd64(8), boot_hp300(8), > > boot_hppa(8), boot_hppa64(8), boot_i386(8), boot_luna88k(8), > > boot_macppc(8), boot_mvme68k(8), boot_mvme88k(8), boot_sparc(8), > > boot_sparc64(8), boot_vax(8), boot_zaurus(8), rc.d(8), rc.shutdown(8), > > savecore(8), shutdown(8), sync(8) > > Hmm, that may be incorrect notation for the pages which are > architecture specific: the boot_*(8) manpages are in the architecture > specific sections. They can be seen on all platforms using the -S > option to man, ala: > > man -S i386 boot_i386 > man -S sparc boot_sparc > ...etc > > By default, man uses the architecture that you're running, so if > you're running on i386, you should be able to just say > man boot_i386 > > I'm not 100% sure if the cross-references in the SEE ALSO section > should be indicating that; I could have sworn that I saw syntax like > "whatever(8/i386)" elsewhere. Jason, Ingo, what the Right Thing here? >
we use 8/i386 notation in man -k (apropos) output, not in man pages, though you can use 8/i386 instead of just 8, and mandoc won;t complain. i suspect ingo will tell us it'll break other tools. in this case it seems clear the intent is to list all the boot_ pages and assume the reader will understand. it's a fair assumption. the alternative is to remove all the platform dependent cross references. i don;t really have a problem with its current format. we do have other pages that reference (by neccesity) platform dependent pages, though they themselves are usually platform dependent. jmc
