[comp.unix.aux] man

jak9213@helios.tamu.edu (John Kane) (10/12/90)

two things on man(1):

1) Where can I get a version of man that understands /usr/man/man*,
   /usr/local/man/man*, /usr/man/cat*, and /usr/local/man/cat* ?

2) Where can I get the nroff sources for the man pages that Apple has
   stuffed into /usr/catman/[apu]_man/man* ?

3) Is there a better way to do this (for local manuals, etc)?

Thanks.

 John Arthur Kane, Systems Analyst, Microcomputer Support and Training
 Texas A&M University, College Station, TX 77843  (409) 845-9999

 jak9213@helios.tamu.edu     profs: x043jk@tamvm1.tamu.edu

marcelo@sparcwood.Princeton.EDU (Marcelo A. Gallardo) (10/12/90)

Hello everyone -

     I have a small question. I have recently set up AUX 2.0 to use my
SyQuest drive. In reading through the AUX manuals, it says that I should
use newfs to create the file system, because that is what AUX prefers.
Fine, that's what I did. 

     I created a directory "users1" where it is currently being mounted.
As root, I have no problems accessing it and using it. As anyone else, I
have a problem with "pwd". It gives me an error saying it can't open.
The exact error is "pwd: getwd: can't open". In checking the man pages
for pwd, it says that an error of "can not open" means that there is
probably something wrong with the file system, but when chacked with
fsck, I get no errors or problems. I'm a little stumped here, as I would
like, as a normal user, to see what directory I'm working in. Any
suggestions?

     On a second note, I've read in the past that people have been able
to use telecom programs from with in AUX (such as Applelink). I
unfortunately have had no luck. AUX always seems to say that the port
that the modem is on is busy. I've checked /etc/inittab and both the
modem and the printer ports are off. Any help with that would be
appreciated too.



    .. Marcelo ..

marcelo@phoenix.princeton.edu
marcelo@sparcwood.princeton.edu
marcelo@pucc.princeton.edu
marcelo@idunno.princeton.edu

Marcelo Gallardo
Test and Evaluation Specialist
Princeton University
Advanced Technologies and Applications
609 - 258 - 5661

jms@apple.com (John Michael Sovereign) (10/12/90)

In article <8991@helios.TAMU.EDU> jak9213@helios.tamu.edu (John Kane) 
writes:
> 2) Where can I get the nroff sources for the man pages that Apple has
>    stuffed into /usr/catman/[apu]_man/man* ?

Unfortunately, AT&T considers the manual page sources to be part of their 
documentation SOURCE and is, therefore, not part of the end-user binary license.  I wish it wasn't so....

John Sovereign
#include <std/disclaimer.h>

urlichs@smurf.sub.org (Matthias Urlichs) (10/12/90)

In comp.unix.aux, article <3289@idunno.Princeton.EDU>,
  marcelo@sparcwood.Princeton.EDU (Marcelo A. Gallardo) writes:
< 
<      I created a directory "users1" where it is currently being mounted.
< As root, I have no problems accessing it and using it. As anyone else, I
< have a problem with "pwd". It gives me an error saying it can't open.

% cd /
% su
# /etc/umount /users1
# chmod 755 /users1
# /etc/mount /users1

<      On a second note, I've read in the past that people have been able
< to use telecom programs from with in AUX (such as Applelink). I
< unfortunately have had no luck. AUX always seems to say that the port
< that the modem is on is busy. I've checked /etc/inittab and both the
< modem and the printer ports are off. Any help with that would be
< appreciated too.
< 
# chmod 666 /dev/tty0

On a related note, be aware that AppleLink wants to use hardware handshaking.
The typical modem cable is wired for DCD/DTR, so AppleLink will hang while
trying to initialize the modem.

To fix, either
- tell the modem to keep DCD turned on (AT &C0 &W should do it),
- use another cable,
- patch AppleLink.

-- 
Matthias Urlichs -- urlichs@smurf.sub.org -- urlichs@smurf.ira.uka.de     /(o\
Humboldtstrasse 7 - 7500 Karlsruhe 1 - FRG -- +49+721+621127(0700-2330)   \o)/

jak9213@helios.TAMU.EDU (John Kane) (10/12/90)

In article <10690@goofy.Apple.COM> jms@apple.com (John Michael Sovereign) writes:
>In article <8991@helios.TAMU.EDU> jak9213@helios.tamu.edu (John Kane) 
>writes:
>> 2) Where can I get the nroff sources for the man pages that Apple has
>>    stuffed into /usr/catman/[apu]_man/man* ?
>
>Unfortunately, AT&T considers the manual page sources to be part of their 
>documentation SOURCE and is, therefore, not part of the end-user binary
>license.  I wish it wasn't so....

I wonder why I have it on Sun OS, on the two Amdhal UTS machines here, on the
R6000 AIX machine, etc.

I really would like to have it. It helps when it is time to print out
a man page, or, heaven forbid, when a change has to be documented.

Hey Apple, (not flaming here, esp. not you jms) couldn't you get us the
sources? Seems like most everyone else does.

Thanks.
-- 
 John Arthur Kane, Systems Analyst, Microcomputer Support and Training
 Texas A&M University, College Station, TX 77843  (409) 845-9999

 jak9213@helios.tamu.edu     profs: x043jk@tamvm1.tamu.edu

karrer@ethz.UUCP (Andreas Karrer) (10/13/90)

In article <8991@helios.TAMU.EDU> jak9213@helios.tamu.edu (John Kane) 
writes:
> 2) Where can I get the nroff sources for the man pages that Apple has
>    stuffed into /usr/catman/[apu]_man/man* ?

ey, they're just pack(1)-ed. Pack/pcat/unpack is a compression program
inferior to compact/uncompact, which in turn is inferior to compress/uncompress.
That't probably the reason att choose it. It's common on sysv machines.

Gig'em.

\\\\\\\\\\
 > Andi Karrer, Communication Systems, ETH Zuerich, Switzerland >
//////////

jak9213@helios.TAMU.EDU (John Kane) (10/13/90)

In article <6177@ethz.UUCP> karrer@ethz.UUCP (Andreas Karrer) writes:
>
>In article <8991@helios.TAMU.EDU> jak9213@helios.tamu.edu (John Kane) 
>writes:
>> 2) Where can I get the nroff sources for the man pages that Apple has
>>    stuffed into /usr/catman/[apu]_man/man* ?
>
>ey, they're just pack(1)-ed. [ ... deleted ... ]

They are not only packed, but they are the output from nroff.

What I would like is the original [nt]roff source files for the man pages.
Shouldn't be too hard to handle, assuming you have space for them :-)

BTW, no one has recommended a replacement for the version of man(1) distributed
by Apple. I still need on that can look in /usr/man/man* /usr/local/man/man*
etc.
-- 
 John Arthur Kane, Systems Analyst, Microcomputer Support and Training
 Texas A&M University, College Station, TX 77843  (409) 845-9999

 jak9213@helios.tamu.edu     profs: x043jk@tamvm1.tamu.edu

rmtodd@servalan.uucp (Richard Todd) (10/13/90)

jak9213@helios.TAMU.EDU (John Kane) writes:
>They are not only packed, but they are the output from nroff.

>What I would like is the original [nt]roff source files for the man pages.
>Shouldn't be too hard to handle, assuming you have space for them :-)

  Alas, the problem is that AT&T changed their mine on the troff input files
for the man pages.  They now claim that those files are *SOURCE* and thus
can't be had without the holy *SOURCE LICENCE*.  (They didn't used to write
the licencing arrangements this way; the change occured in some version of
SysV.  To the guy who asked how come Sun can ship troff source for the man
pages: SunOS is based on BSD, which in turn is based on AT&T V32, and V32
didn't have this bogus addition to the licence agreement.  I think all SysV
releases R2 or later did have this restriction...)

  Is this braindead?  You bet.  Is there anything that can be done about it,
short of hoping that AT&T changes the licence agreement for SVR4?  Nope.  

>BTW, no one has recommended a replacement for the version of man(1) distributed
>by Apple. I still need on that can look in /usr/man/man* /usr/local/man/man*
>etc.

   Uh, if you look at /usr/bin/man, you'll find that it's a shell script.
You should be able to hack it to look in other places for man files.  
Alternately, you can grab the source for the BSD man command off of uunet
and hack to your heart's content.  
--
Richard Todd	rmtodd@uokmax.ecn.uoknor.edu  rmtodd@chinet.chi.il.us
"Cancelling a posted message means posting a cancel message."-Maarten Litmaath

jsb@panix.uucp (J. S. B'ach) (10/16/90)

In article <3289@idunno.Princeton.EDU> marcelo@sparcwood.Princeton.EDU (Marcelo A. Gallardo) writes:
)
)Hello everyone -
)
)     I have a small question. I have recently set up AUX 2.0 to use my
)SyQuest drive. In reading through the AUX manuals, it says that I should
)use newfs to create the file system, because that is what AUX prefers.
)Fine, that's what I did. 
)
)     I created a directory "users1" where it is currently being mounted.
)As root, I have no problems accessing it and using it. As anyone else, I
)have a problem with "pwd". It gives me an error saying it can't open.
)The exact error is "pwd: getwd: can't open". In checking the man pages
)for pwd, it says that an error of "can not open" means that there is
)probably something wrong with the file system, but when chacked with
)fsck, I get no errors or problems. I'm a little stumped here, as I would
)like, as a normal user, to see what directory I'm working in. Any
)suggestions?

The message is can't open ., '.' being the directory name.  I posted
this problem to this group and got no replies but have since discovered
the following:  
1) The problem only occurs on directories with inode numbers > 16 bits
   (or with ancestors with big i-numbers)  Try ls -i and see if this
   is true for you.

2) The fix involves recompilation.  If you can't recompile and you only
   have the problem with users1, make a new users 1 with a smaller
   i-number.
-- 
    jim (rutgers!cmcl2!panix!jsb,  uunet!jyacc!jsb, or apple!panix!jsb)

    "We have no art.  We sell everything for as much as we can get."

ron@xwind.UUCP (Ronald P. Hughes) (10/21/90)

In article <1990Oct12.223848.22890@servalan.uucp> rmtodd@servalan.uucp (Richard Todd) writes:
>jak9213@helios.TAMU.EDU (John Kane) writes:
>>What I would like is the original [nt]roff source files for the man pages.
>
>  Alas, the problem is that AT&T changed their mine on the troff input files
>for the man pages.  They now claim that those files are *SOURCE* and thus
>can't be had without the holy *SOURCE LICENCE*.
...
>  Is this braindead?  You bet.  Is there anything that can be done about it,
>short of hoping that AT&T changes the licence agreement for SVR4?  Nope.  

I'll bet it wouldn't be too tough to write something that translates nroff
output for man pages back into the original nroff/troff source (please note
that I'm talking only about man page output, not general nroff output).  In
fact, I would be surprised if it hasn't already been done by someone.  If
it hasn't, I might be willing to do it if there is enough interest to allow
me to pass the hat around when I'm done...  Hey, think of the money we could
save by not having to purchase Apple A/UX manuals.  We could print our own on
laser printers.  LaserWriters, which we would purchase from Apple, of course
(I just added that last comment to calm down Apple's legal dogs).

Ronald P. Hughes		ron@xwind.com  (or ...!uunet!xwind!ron)
CrossWind Technologies, Inc.	408-335-4988

STANDARD DISCLAIMER:  I didn't say that!