Re: [ijbswa-devel] manpage (1 or 2) ?

[Rodrigo Barbosa <rodrigob@ti...>]

So, it's official. The manpage stays on section 1.

Sephan, do you mind seconding that ? Just to make sure no one gets it
wrong. If you and Andreas stating it clearly, there should be no
further confusion.

On Sun, Mar 24, 2002 at 10:56:24PM +0100, Andreas Oesterhelt wrote:
> Hi,
> 
> > Anyway, we need some official position on this. Stephan ?
> 
> >From the FHS:
> 
>   o man1: User programs
>     Manual pages that describe publicly accessible commands are
>     contained in this chapter.  Most program documentation that a
>     user will need to use is located here.
> 
>   o man8: System administration
>     Programs used by system administrators for system operation and
>     maintenance are documented here.  Some of these programs are also
>     occasionally useful for normal users.
> 
> So no conclusive advice here. Some say all commands that require root
> privs belong to 8. We don't. See if it holds for proxies: tproxy requires
> root, is in man8, squid doesn't, is in 1. So it's 1, I suppose.
> 
> Regards,
> --Andreas
> 

-- 
 Rodrigo Barbosa                   - rodrigob at tisbrasil.com.br
 TIS 				   - Belo Horizonte, MG, Brazil
 "Quis custodiet ipsos custodes?"  - http://www.tisbrasil.com.br/
 Brainbench Certified -> Transcript ID #3332104

[ijbswa-devel] manpage (1 or 2) ?

[Rodrigo Barbosa <rodrigob@ti...>]

Okey, looks like Hal put the manpage back to section 1.
Is that the way it should stay ? I'm a little lost here.

I'll be heeping it that way for now.

[]s

-- 
 Rodrigo Barbosa                   - rodrigob at tisbrasil.com.br
 TIS 				   - Belo Horizonte, MG, Brazil
 "Quis custodiet ipsos custodes?"  - http://www.tisbrasil.com.br/
 Brainbench Certified -> Transcript ID #3332104

Re: [ijbswa-devel] manpage (1 or 2) ?

[Hal Burgiss <hal@bu...>]

On Sun, Mar 24, 2002 at 06:04:19PM -0300, Rodrigo Barbosa wrote:
> Okey, looks like Hal put the manpage back to section 1.
> Is that the way it should stay ? I'm a little lost here.

Me too. There was a conflict, and I couldn't remember if we decided
section 1 or 8 :/ So I used section 1 since that is how the man page is
named. I don't see a problem as long as its consistent.

The problem before was the it was installed in one section, and the
man page itself was labeled for another section. At least on RH.
 
> I'll be heeping it that way for now.

OK, by me ...

-- 
Hal Burgiss
 

Re: [ijbswa-devel] manpage (1 or 2) ?

[Rodrigo Barbosa <rodrigob@ti...>]

On Sun, Mar 24, 2002 at 04:14:20PM -0500, Hal Burgiss wrote:
> On Sun, Mar 24, 2002 at 06:04:19PM -0300, Rodrigo Barbosa wrote:
> > Okey, looks like Hal put the manpage back to section 1.
> > Is that the way it should stay ? I'm a little lost here.
> 
> Me too. There was a conflict, and I couldn't remember if we decided
> section 1 or 8 :/ So I used section 1 since that is how the man page is
> named. I don't see a problem as long as its consistent.
> 
> The problem before was the it was installed in one section, and the
> man page itself was labeled for another section. At least on RH.

It has been addressed some time ago on the specfile (that sed line).

Anyway, we need some official position on this. Stephan ?

>  
> > I'll be heeping it that way for now.
> 
> OK, by me ...
> 
> -- 
> Hal Burgiss
>  

-- 
 Rodrigo Barbosa                   - rodrigob at tisbrasil.com.br
 TIS 				   - Belo Horizonte, MG, Brazil
 "Quis custodiet ipsos custodes?"  - http://www.tisbrasil.com.br/
 Brainbench Certified -> Transcript ID #3332104

Re: [ijbswa-devel] manpage (1 or 2) ?

[Stefan Waldherr <stefan@wa...>]

Rodrigo Barbosa wrote:

> 
> It has been addressed some time ago on the specfile (that sed line).
> 
> Anyway, we need some official position on this. Stephan ?

actually, I don't mind. put it somewhere. keep it consistent 
with both spec files and its content.

stefan
-- 
Stefan Waldherr                   fax +49 89 2443 29533
                               e-Mail stefan@...
                                  www http://www.waldherr.org/

Re: [ijbswa-devel] manpage (1 or 2) ?

[Andreas Oesterhelt <oes@oe...>]

Hi,

> Anyway, we need some official position on this. Stephan ?

From the FHS:

  o man1: User programs
    Manual pages that describe publicly accessible commands are
    contained in this chapter.  Most program documentation that a
    user will need to use is located here.

  o man8: System administration
    Programs used by system administrators for system operation and
    maintenance are documented here.  Some of these programs are also
    occasionally useful for normal users.

So no conclusive advice here. Some say all commands that require root
privs belong to 8. We don't. See if it holds for proxies: tproxy requires
root, is in man8, squid doesn't, is in 1. So it's 1, I suppose.

Regards,
--Andreas

Re: [ijbswa-devel] manpage (1 or 2) ?

[Rodrigo Barbosa <rodrigob@ti...>]

So, it's official. The manpage stays on section 1.

Sephan, do you mind seconding that ? Just to make sure no one gets it
wrong. If you and Andreas stating it clearly, there should be no
further confusion.

On Sun, Mar 24, 2002 at 10:56:24PM +0100, Andreas Oesterhelt wrote:
> Hi,
> 
> > Anyway, we need some official position on this. Stephan ?
> 
> >From the FHS:
> 
>   o man1: User programs
>     Manual pages that describe publicly accessible commands are
>     contained in this chapter.  Most program documentation that a
>     user will need to use is located here.
> 
>   o man8: System administration
>     Programs used by system administrators for system operation and
>     maintenance are documented here.  Some of these programs are also
>     occasionally useful for normal users.
> 
> So no conclusive advice here. Some say all commands that require root
> privs belong to 8. We don't. See if it holds for proxies: tproxy requires
> root, is in man8, squid doesn't, is in 1. So it's 1, I suppose.
> 
> Regards,
> --Andreas
> 

-- 
 Rodrigo Barbosa                   - rodrigob at tisbrasil.com.br
 TIS 				   - Belo Horizonte, MG, Brazil
 "Quis custodiet ipsos custodes?"  - http://www.tisbrasil.com.br/
 Brainbench Certified -> Transcript ID #3332104

Re: [ijbswa-devel] manpage (1 or 2) ?

[Stefan Waldherr <stefan@wa...>]

Rodrigo Barbosa wrote:
> Sephan, do you mind seconding that ? Just to make sure no one gets it
> wrong. If you and Andreas stating it clearly, there should be no
> further confusion.

fine with me. keep the momentum ...

-stefan
-- 
Stefan Waldherr                   fax +49 89 2443 29533
                               e-Mail stefan@...
                                  www http://www.waldherr.org/