Re: man-intro(1) [patch]

2023-03-06 Thread Alejandro Colomar
-pages. But I can do the transformation if necessary. > > --jikl > > [snip] > .Dd May 17, 2021 > .Dt MAN-INTRO 1 > .\"Os [OPERATING_SYSTEM] [version/release] > .Sh NAME > .Nm man-intro > .Sh DESCRIPTION > Most of the software installed on the system you are usin

Re: Why no cd(1) man page in Ubuntu? (was: man-intro)

2021-05-29 Thread James K. Lowden
d, as evidenced by its abandonment of info(1) in favor of man(1). But the conversion is incomplete and (in my estimation) likely to remain that way. --jkl P.S. I have version 2 of man-intro.1 ready, but I want to make sure I've incorporated all feedback before I post it. As you can see from this post and the next, I got ... distracted.

Re: man-intro (was: getting more out of man pages with less(1) )

2021-05-28 Thread Larry Kollar
James K. Lowden wrote: > Attached is a straw man 1st draft of what an introduction to the man > system might look like. If it clears the threshold of raspberries, > perhaps we can mold it into something useful. > > I think the page should be called man-intro, or intro-man

Re: man-intro

2021-05-26 Thread Dave Kemper
On 5/23/21, Oliver Corff wrote: > in a follow-up to my last message I just want to give one real-world > example of a very terse manpage, "for the initiated reader only." > > Take refer(1). There is an open bug report documenting the deficiencies of the refer man page (http://savannah.gnu.org/bug

Re: man-intro

2021-05-23 Thread Peter Schaffter
On Sun, May 23, 2021, Oliver Corff wrote: > in a follow-up to my last message I just want to give one > real-world example of a very terse manpage, "for the initiated > reader only." > > Take refer(1). > Terseness is nice, but in the case presented here the first paragraph of > DESCRIPTION in the

Re: man-intro

2021-05-23 Thread Oliver Corff
ference between man and help? Not finding "cd" in a man page means that it is a shell internal; this could be stated as an explicite reason why it doesn't come with its own manpage. Perhaps a note of caution to the novice reader could be added in man-intro by mentioning that a sm

Re: man-intro

2021-05-23 Thread Oliver Corff
eader could be added in man-intro by mentioning that a small number of utilities do not come with their associated manpage, but require --help for an overview of invocation, arguments and parameters, while other "subsystems" (I think of TeX and friends) come with their own, extensive do

Why no cd(1) man page in Ubuntu? (was: man-intro)

2021-05-22 Thread G. Branden Robinson
Hi Clarke, At 2021-05-22T21:09:56-0600, Clarke Echols wrote: > I don't know why that would occur... > > (Aside note): > [In the HP-UX Reference Manual (HP's Unix which was POSIX compliant) I > produced in late 1992, which contained all manpages, there is a > manpage included in Volume 1 on page 9

Re: man-intro

2021-05-22 Thread Clarke Echols
I don't know why that would occur... (Aside note): [In the HP-UX Reference Manual (HP's Unix which was POSIX compliant) I produced in late 1992, which contained all manpages, there is a manpage included in Volume 1 on page 91 and 92 with the heading at the top of each past: "cd(1)".  The manual c

Re: man-intro

2021-05-22 Thread Steffen Nurpmeso
Ulrich Lauther wrote in <20210522214249.GA20730@starlite>: |On Sat, May 22, 2021 at 08:18:41PM +0200, Oliver Corff wrote: |> |> "man cd", on the other hand, opens the bash built-in command *man page*, |> which, at least on my system is a plethora of text to read (and digest). |> |on my syt

Re: man-intro

2021-05-22 Thread Ulrich Lauther
On Sat, May 22, 2021 at 08:18:41PM +0200, Oliver Corff wrote: > > "man cd", on the other hand, opens the bash built-in command *man page*, > which, at least on my system is a plethora of text to read (and digest). > on my sytem (ubunto mate) "man cd" results in "No manual entry for cd". > Just m

Re: man-intro

2021-05-22 Thread Oliver Corff
ning into a general "intro to Linux" page, but that was, to my mind, always going to be an impossibly huge scope. I'm not a huge fan of what is there. Attached is a straw man 1st draft of what an introduction to the man system might look like. If it clears the threshold of raspberries,

Re: man-intro (was: getting more out of man pages with less(1) )

2021-05-22 Thread Dave Kemper
On 5/17/21, James K. Lowden wrote: > Attached is a straw man 1st draft of what an introduction to the man > system might look like. If it clears the threshold of raspberries, > perhaps we can mold it into something useful. I think it looks great! I'm admittedly not its target audience, as I hav

Re: man-intro (was: getting more out of man pages with less(1) )

2021-05-17 Thread James K. Lowden
is a straw man 1st draft of what an introduction to the man system might look like. If it clears the threshold of raspberries, perhaps we can mold it into something useful. I think the page should be called man-intro, or intro-man. (Need help? Never fear, Intro Man is here!) I included what