Re: man 1 eject [DaleCo]

2002-11-07 Thread Ceri Davies
On Wed, Nov 06, 2002 at 11:32:25PM -0500, Peter Leftwich wrote:

 Are we closer to getting to the bottom of this?  I don't remember choosing
 to install eject manually from my original /stand/sysinstall install.

pkg_info -W eject

Ceri
-- 
The warriors of my elders have come!

To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: man 1 eject [Giorgos]

2002-11-07 Thread Giorgos Keramidas
On 2002-11-06 23:29, Peter Leftwich [EMAIL PROTECTED] wrote:
 On Tue, 5 Nov 2002, Giorgos Keramidas wrote:
  keramida@gray[16:11]/home/keramida$ man -w eject
  No manual entry for eject
  What does man -w tell you?
 
 # man -w eject
 /usr/local/man/cat1/eject.1.gz (source: /usr/local/man/man1/eject.1.gz)
 
 Don't know if that helps you.

Yep.  Manpages that are installed from the base system sources are
installed under /usr/share/man not /usr/local/man.  The path that man
prints here means that your manpage is installed as part of a port.
Therefore, the source of the port is not under the control of the
FreeBSD developers only, but a vendor is involved too.  New
features, changes to the way the program works, bugfixes and other
useful changes should probably go to the original authors first :-)

To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: man 1 eject [Giorgos]

2002-11-06 Thread Peter Leftwich
On Tue, 5 Nov 2002, Giorgos Keramidas wrote:
   Perhaps NetBSD has an eject program as part of the OS, but FreeBSD does not.
  The manpage seems to indicate otherwise:
  HISTORY
 The eject command appeared in FreeBSD 2.X
  FreeBSD 4.6.2 Jul 1, 1996FreeBSD 4.6.2
 I don't have an eject manpage in my FreeBSD 5.x installation:

Brave soul, running an Alpha (Beta?) OS.

   keramida@gray[16:11]/home/keramida$ man -w eject
   No manual entry for eject
 What does man -w tell you?

# man -w eject
/usr/local/man/cat1/eject.1.gz (source: /usr/local/man/man1/eject.1.gz)

Don't know if that helps you.

--
Peter Leftwich
President  Founder
Video2Video Services
Box 13692, La Jolla, CA, 92039 USA
+1-413-403-9555


To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: man 1 eject [DaleCo]

2002-11-06 Thread Peter Leftwich
On Tue, 5 Nov 2002, DaleCo Help Desk wrote:
  I don't have an eject manpage in my FreeBSD 5.x installation:
 Nor does the FBSD site in -STABLE:
 
http://www.freebsd.org/cgi/man.cgi?query=ejectapropos=0sektion=0manpath=FreeBSD+4.7-stableformat=html

What does the above show, no results?

 Sorry, no data found for `eject'.
 You may look for other FreeBSD Search Services.


 Peter, what in the *header* of your eject manpage?  Generally, FBSD's own
 manpages show up with FreeBSD System Manager's Manual, or FreeBSD
 General Commands Manual, etc., etc.
 Kevin Kinsey
 DaleCo, S.P.

The header, as in the first few lines of groffed manpage text?  It shows:
EJECT(1)FreeBSD General Commands Manual   EJECT(1)
NAME
 eject - eject removable media from drive

Are we closer to getting to the bottom of this?  I don't remember choosing
to install eject manually from my original /stand/sysinstall install.

--
Peter Leftwich
President  Founder
Video2Video Services
Box 13692, La Jolla, CA, 92039 USA
+1-413-403-9555


To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: man 1 eject

2002-11-05 Thread Giorgos Keramidas
On 2002-11-05 02:10, Peter Leftwich [EMAIL PROTECTED] wrote:
 On Mon, 4 Nov 2002, Sue Blake wrote:
  Peter, I think Greg is saying that there's no man page for eject in
  FreeBSD, because that program is not part of the operating system.
  Perhaps NetBSD has an eject program as part of the OS, but FreeBSD does not.

 The manpage seems to indicate otherwise:

 HISTORY
The eject command appeared in FreeBSD 2.X
 FreeBSD 4.6.2 Jul 1, 1996FreeBSD 4.6.2

I don't have an eject manpage in my FreeBSD 5.x installation:

keramida@gray[16:11]/home/keramida$ man -w eject
No manual entry for eject

What does man -w tell you?

To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: man 1 eject

2002-11-05 Thread DaleCo Help Desk

From: Giorgos Keramidas [EMAIL PROTECTED]
Sent: Tuesday, November 05, 2002 8:12 AM
Subject: Re: man 1 eject
 On 2002-11-05 02:10, Peter Leftwich [EMAIL PROTECTED]
wrote:
  On Mon, 4 Nov 2002, Sue Blake wrote:
   Peter, I think Greg is saying that there's no man page for
eject in
   FreeBSD, because that program is not part of the operating
system.
   Perhaps NetBSD has an eject program as part of the OS, but
FreeBSD does not.
 
  The manpage seems to indicate otherwise:
 
  HISTORY
 The eject command appeared in FreeBSD 2.X
  FreeBSD 4.6.2 Jul 1, 1996
FreeBSD 4.6.2

 I don't have an eject manpage in my FreeBSD 5.x installation:

Nor does the FBSD site in -STABLE:

http://www.freebsd.org/cgi/man.cgi?query=ejectapropos=0sektion=0ma
npath=FreeBSD+4.7-stableformat=html
Sorry, no data found for `eject'.
You may look for other FreeBSD Search Services.

Peter, what in the *header* of your eject
manpage?  Generally, FBSD's own man-
pages show up with FreeBSD System
Manager's Manual, or FreeBSD General
Commands Manual, etc., etc.

Kevin Kinsey
DaleCo, S.P.


To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: man 1 eject

2002-11-05 Thread Roman Neuhauser
# [EMAIL PROTECTED] / 2002-11-05 16:12:49 +0200:
 On 2002-11-05 02:10, Peter Leftwich [EMAIL PROTECTED] wrote:
  On Mon, 4 Nov 2002, Sue Blake wrote:
   Peter, I think Greg is saying that there's no man page for eject in
   FreeBSD, because that program is not part of the operating system.
   Perhaps NetBSD has an eject program as part of the OS, but FreeBSD
   does not.
 
  The manpage seems to indicate otherwise:
 
  HISTORY
 The eject command appeared in FreeBSD 2.X
  FreeBSD 4.6.2 Jul 1, 1996FreeBSD 4.6.2
 
 I don't have an eject manpage in my FreeBSD 5.x installation:
 
   keramida@gray[16:11]/home/keramida$ man -w eject
   No manual entry for eject

nor do I in 4.7-STABLE.

 What does man -w tell you?

roman@freepuppy ~ 1001:0  man -w eject
No manual entry for eject
 
-- 
If you cc me or take the list(s) out completely I'll most likely ignore
your message.  see http://www.eyrie.org./~eagle/faqs/questions.html

To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Manual title standards (was: man 1 eject)

2002-11-05 Thread Gary W. Swearingen
DaleCo Help Desk [EMAIL PROTECTED] writes:

 Peter, what in the *header* of your eject
 manpage?  Generally, FBSD's own man-
 pages show up with FreeBSD System
 Manager's Manual, or FreeBSD General
 Commands Manual, etc., etc.

Changing the subject, those FreeBSD ... Manual strings are the default
middle portion of a manual entry's title as produced by the required
mdoc(7) .Dt macro when the section number is given, but the volume
is not given.  (The left and right portions are usually like EJECT(1).)

There is apparently no standard on what the title should be.  There are
non-FreeBSD parts (eg, named(8)) of the base OS which use the default
title.  There are ports (eg, eject(1) and portupgrade(1)) which do the
same.  Most of the ports I looked at have no middle portion.  A few have
silly things like FSF (grub(8)).  Some seem to be in parts of their
manual like Ruby Programmers Reference Manual (ruby(1)).

Many of the ports will never be patched to have correct titles, but
do you all think there should be a standard on titling? Or is there one?
Where should it be found?  mdoc(7)?

Should we pretend that there is only one UNIX or System or FreeBSD
manual, or also a Ruby Manual, etc?

Should the title (middle portition) of every page of a section, be the
same?  (A porter's script could probably enforce that standard.)

Should the title (middle portition) be the same across the whole manual?

Should the titles be unique to parts of the base system, so that other
non-base entries MUST NOT use those titles?  Or instead of base system
should it be FreeBSD parts of the base system?


My preference is that all entries use section-default titles, and that
ports be (auto-)patched to conform.  I'd prefer a one-manual style:
INTRO(5) FreeBSD Manual (File Formats)INTRO(5)
PORTUPGRADE(1) FreeBSD Manual (General Commands)PORTUPGRADE(1)

Whether the entry is associated with the base OS or ports, etc., should
be noted in the body of the entry, under a separate standard, by those
who care.  (The History section might be OK for it, but I think a new
section is needed for info like that and especially for bug reporting
info.)

To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: Manual title standards (was: man 1 eject)

2002-11-05 Thread Giorgos Keramidas
On 2002-11-05 13:02, Gary W. Swearingen [EMAIL PROTECTED] wrote:
 DaleCo Help Desk [EMAIL PROTECTED] writes:
  Peter, what in the *header* of your eject manpage?  Generally,
  FBSD's own manpages show up with FreeBSD System Manager's
  Manual, or FreeBSD General Commands Manual, etc., etc.
 [...]
 There is apparently no standard on what the title should be.  There are
 non-FreeBSD parts (eg, named(8)) of the base OS which use the default
 title.  There are ports (eg, eject(1) and portupgrade(1)) which do the
 same.  Most of the ports I looked at have no middle portion.  A few have
 silly things like FSF (grub(8)).  Some seem to be in parts of their
 manual like Ruby Programmers Reference Manual (ruby(1)).

It's probably a hell of a maintenance load to patch all those ports
and keep them updated.  Even for manpages that are part of the base
system the developers are cautious to avoid committing changes that
are trivial and will cause conflicts in later imports of the source
from the vendor's releases :/

To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: man 1 eject

2002-11-04 Thread Peter Leftwich
On Mon, 4 Nov 2002, Sue Blake wrote:
 On Mon, Nov 04, 2002 at 02:18:18AM -0500, Peter Leftwich wrote:
  On Mon, 4 Nov 2002, Greg 'groggy' Lehey wrote:
   Hmm.  Before we can improve the man page, we have to write it.  Are
   you confusing FreeBSD with NetBSD?
   Greg
  I don't get it.

 Peter, I think Greg is saying that there's no man page for eject in
 FreeBSD, because that program is not part of the operating system.
 Perhaps NetBSD has an eject program as part of the OS, but FreeBSD does not.

The manpage seems to indicate otherwise:

HISTORY
   The eject command appeared in FreeBSD 2.X
FreeBSD 4.6.2 Jul 1, 1996FreeBSD 4.6.2

 Greg, I think Peter might have installed the sysutils/eject port and
 forgotten that it was installed as an additional program. In that case
 he'd need to find out who wrote the eject program and send his feedback there.
 Regards, -*Sue*-
 http://www.sievx.com/

I still suggest a command-line flag to do the opposite of eject.  :)

--
Peter Leftwich
President  Founder
Video2Video Services
Box 13692, La Jolla, CA, 92039 USA
+1-413-403-9555


To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



man 1 eject

2002-11-03 Thread Peter Leftwich
A question and a suggestion to improve the eject(1) manpage.

Question: Why is there no SEE ALSO section for a command (if one exists)
to insert the CD tray using the command line?

Suggestion: The manpage could be clearer about not accepting the full
device path, such as /dev/acd1c, and instead using eject acd1 for example.

--
Peter Leftwich
President  Founder
Video2Video Services
Box 13692, La Jolla, CA, 92039 USA
+1-413-403-9555


To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: man 1 eject

2002-11-03 Thread Greg 'groggy' Lehey
On Sunday,  3 November 2002 at 13:39:46 -0800, Peter Leftwich wrote:
 A question and a suggestion to improve the eject(1) manpage.

 Question: Why is there no SEE ALSO section for a command (if one exists)
 to insert the CD tray using the command line?

 Suggestion: The manpage could be clearer about not accepting the full
 device path, such as /dev/acd1c, and instead using eject acd1 for example.

Hmm.  Before we can improve the man page, we have to write it.  Are
you confusing FreeBSD with NetBSD?

Greg
--
See complete headers for address and phone numbers

To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message



Re: man 1 eject

2002-11-03 Thread Peter Leftwich
On Mon, 4 Nov 2002, Greg 'groggy' Lehey wrote:
 Hmm.  Before we can improve the man page, we have to write it.  Are
 you confusing FreeBSD with NetBSD?
 Greg
 See complete headers for address and phone numbers

I don't get it.

--
Peter Leftwich
President  Founder
Video2Video Services
Box 13692, La Jolla, CA, 92039 USA
+1-413-403-9555


To Unsubscribe: send mail to [EMAIL PROTECTED]
with unsubscribe freebsd-questions in the body of the message