Re: [Sccs-devel] Installation/documentation discrepancy bug (5.08)

[Bruce L. <bru...@gm...>]

Comments in-line below.

On Tue, Oct 13, 2015 at 6:43 AM, Joerg Schilling
<Joe...@fo...> wrote:
> Bruce Lilly <bru...@gm...> wrote:
[...]
>> The man pages also have these locations baked in, for example:
>>
>>    /usr/ccs/bin/get [-beFgkmnopst] [-l [p]] [-asequence]
>>    /usr/xpg4/bin/get [-beFgkmnopst] [-l [p]] [-asequence]
>>    /usr/ccs/bin/get
>>    /usr/xpg4/bin/get
>>    -rsid         Same as for /usr/ccs/bin/get except that SID is mandatory.
>>    -xsid-list   Same as  for  /usr/ccs/bin/get  except  that  sid-list  is
>>    /usr/ccs/bin/get
>>    The output format for /usr/ccs/bin/get is as follows:
>>    /usr/xpg4/bin/get
>>    The output format for /usr/xpg4/bin/get is as follows:
>>    /usr/ccs/bin/get
>>    /usr/xpg4/bin/get
>>
>>
>> Obviously, neither the README.SCCS nor the generated man pages reflect the
>> actual install location, which is /opt/schily/....
>
> Most of the locations in the man files that mention a PATH use this to distinct
> bewteen different compile options (e.g. traditional UNIX vs. X-OPEN issue 4).
>
> Note that X-OPEN issue 4 is POSIX.1-1990 with a state from 1992. That standard
> rearranged the rules for Utility Syntax Guidelines and needs a slightly
> modified command line (option) parser.

Looking at The Open Group Base Specifications Issue 7 IEEE Std 1003.1,
2013 Edition, I see
"The get utility shall conform to XBD Utility Syntax Guidelines .",
so "-rsid" would not be permissible per Guideline 6 (sid, as a mandatory
option argument must be separate from the -r flag), and the page for get there
shows that.  But that's another issue.

> Given that the man pages are originally taken from OpenSolaris, I would like to
> keep the /usr/ccs and /usr/xpg4 paths intact. Yould you be OK with a NOTE that
> explains that /usr/ has to be replaced by the "installation base" directory?

I suppose so; better would be to make those the default installation
locations (I
suspect that there are very few people with anything under /opt/schily
in $PATH)...