Beta
×

Welcome to the Slashdot Beta site -- learn more here. Use the link in the footer or click here to return to the Classic version of Slashdot.

Thank you!

Before you choose to head back to the Classic look of the site, we'd appreciate it if you share your thoughts on the Beta; your feedback is what drives our ongoing development.

Beta is different and we value you taking the time to try it out. Please take a look at the changes we've made in Beta and  learn more about it. Thanks for reading, and for making the site better!

Man Page Project Can Now Use Official POSIX Docs

timothy posted more than 10 years ago | from the now-they-should-say-that-sco-cannot dept.

Unix 229

Martin_Sturm writes "The IEEE consortium announces in a recent press release that it granted permission to the Linux Man Page Project to incorporate material from the official documentation on the POSIX standard. Obviously this is very good news for the Man Page project which now has access to a huge amount of good documentation. Until recently the project could not use this documentation due to copyright restricions."

cancel ×

229 comments

Sorry! There are no comments related to the filter you selected.

yay! (2, Funny)

Ozone Depletion (738650) | more than 10 years ago | (#8077629)

I love my man! 3

MAY YOUR BOWELS RUPTURE AND YOUR TESTES EXPLODE (-1, Flamebait)

Anonymous Coward | more than 10 years ago | (#8077654)

Good Show (0, Offtopic)

t0ny (590331) | more than 10 years ago | (#8077860)

I like "The Man Show", but its just not the same since they got the Jimmy Kimmel and Adam Carolla impersonators on there.

Caution! NSFW! (0)

Anonymous Coward | more than 10 years ago | (#8077900)

Offensive ASCII graphic in parent post! Do not look!

they're called "man" pages for a reason (-1, Troll)

Anonymous Coward | more than 10 years ago | (#8077636)

batman touched my junk liberally. he strapped me in to his batmobile and he couldnt keep his offensive hands off of me. he was performing many red flag touches. i couldnt believe what the fuck was going on. i told batman the city would not approve of a millionaire touching an underage kid for free.

Can you believe it? Batman did all this. He picked me off the street, strapped my arms and legs down in the batmobile's passenger seat, and just wouldn't stop fondling my cock'n'balls.

They definately were red flag touches. the goddamn referee he had in the back seat kept on raising up this red flag every time he touched my junk but did batman care? NO WAY! He just kept on doing it. I couldn't believe what the fuck was going on, indeed. I pleaded with Mr. Wayne but to no avail. I told him the city would not approve of such a wealthy man touching an underage kid like me (at the time I was 13) without at least compensating me for the trauma and the use of my body as his own personal plaything.

This got to him, worrying about his image. He continued to fondle me, all the while ignoring the referee's red flags. Then he drove the batmobile to my house and *ejected the seat I was in*! It was amazing. But surprisingly, after I woke up the next morning, my bank account had $150k in it!!! Can you believe it?????????

Re:they're called "man" pages for a reason (-1, Troll)

Anonymous Coward | more than 10 years ago | (#8077712)

But surprisingly, after I woke up the next morning, my bank account had $150k in it!!!
The sad thing is that you wouldn't be able to buy you a new brain, even with all that money...

Wow. (0)

Anonymous Coward | more than 10 years ago | (#8077823)

This is even better than the "my head hurts" stories.

nothing (-1, Troll)

Anonymous Coward | more than 10 years ago | (#8077642)

the man format sucks

Re:nothing (-1, Offtopic)

Anonymous Coward | more than 10 years ago | (#8077697)

In Soviet Russia, man format sucks YOU !!!

Lot's of truth in the Parent! (0, Flamebait)

Saeed al-Sahaf (665390) | more than 10 years ago | (#8077729)

Funny, because... The man page format *does* suck. But I guess one must say it differently to avoid to "troll" modifier.

Truth is, man pages are almost unreadable, unless you already know the material, they are not designed for the unwashed like you and I. They are meant for the gurus and the Illuminati who already know the material, basically an exercise in masturbation.

Re:Lot's of truth in the Parent! (1)

zurab (188064) | more than 10 years ago | (#8077998)

Truth is, man pages are almost unreadable, unless you already know the material, they are not designed for the unwashed like you and I. They are meant for the gurus and the Illuminati who already know the material, basically an exercise in masturbation.


Most developers who would be interested in reading POSIX standards would be comfortable using man pages.

For a better view of man page documentation, try typing man:/traceroute (or your favorite program) in Konqueror, or simply man:/ for man pages index.

Re:Lot's of truth in the Parent! (1)

Spoing (152917) | more than 10 years ago | (#8078009)

  1. Truth is, man pages are almost unreadable, unless you already know the material,

Exactly.

  1. they are not designed for the unwashed like you and I.

*BLINK* This "you and I" you speak of...figure of speach?

bah! (3, Funny)

monkey_jam (557265) | more than 10 years ago | (#8077644)

real *nix users dont need man pages!

Re:bah! (2)

Richard_at_work (517087) | more than 10 years ago | (#8077702)

Nope, GNU seems to think they need info pages more tho :(

Re:bah! (4, Insightful)

bersl2 (689221) | more than 10 years ago | (#8077743)

Seriously, besides GNU, who else favors info over man? I find the system difficult to navigate. For instance, when I was first learning {,ba}sh... damn, the bash info page sucks.

Re:bah! (1, Informative)

Anonymous Coward | more than 10 years ago | (#8077830)

Get pinfo [sourceforge.net] then. It's much more usable than that crappy info.

Re:bah! (1)

madpierre (690297) | more than 10 years ago | (#8077897)

One word ...

Emacs ;)

Re:bah! (1)

Mr. Piddle (567882) | more than 10 years ago | (#8077921)

Seriously, besides GNU, who else favors info over man?

Leave it to GNU to create something clumsier than a man page for quick reference and less useful than HTML or PDF for large documents. Man pages are one area that OpenBSD, for example, got it right.

Man & Info (0)

ciaran_o_riordan (662132) | more than 10 years ago | (#8077952)

> besides GNU, who else favors info over man?

When I need a quick reference, I use --help, when I need in-depth documentation, I look at an Info manual.

If you don't like the command line 'info' utility, use one of the GNOME or KDE front ends, or try 'info --vi-keys', or try an alternative commandline info reader such as pinfo. (or write your own frontend, the GNU Info file format is very simlpe.)

How would the 650 page GCC manual look as a man page? or how would you break it down into 300 individual pages? How do you turn 650 pages worth of manpages into a printable (and readable) book?

I hated info when I was a newbie, but once you get used to it, it's quite good.

Re:Man & Info (5, Informative)

AJWM (19027) | more than 10 years ago | (#8078078)

How would the 650 page GCC manual look as a man page?

Like it was done by someone who didn't understand the Unix documentation scheme.

The man pages were never the entire body of Unix documentation, just the first volume. The second volume consisted of longer, more tutorial or in depth documents for the programs that needed it. (Like some compilers, or awk, or [t]roff, etc.)

Way back in prehistory I worked with a port of Version 7 Unix (UTS) that came with a complete set of printed manuals -- the man pages were only half the documentation.

That said, info is lame, and commands that have no man page because they have info doubly so.

Re:bah! (1, Funny)

plams (744927) | more than 10 years ago | (#8077706)

real *nix user not need man!
real *nix user need wo-man! badly!

Re:bah! (1)

Uber Banker (655221) | more than 10 years ago | (#8077827)

Real *nix systems are POSIX compliant, Linux is not.

Re:bah! (0)

Anonymous Coward | more than 10 years ago | (#8077847)

Unix is archaic. Linux is not.

Re:bah! (1)

Mr. Piddle (567882) | more than 10 years ago | (#8077937)

Unix is archaic. Linux is not.

I'll take my vi text editor that doesn't render HTML instead of displaying the text, thank you very much!

Also, saying "Linux" is too general. For example, it would be better to say, "Red Hat is archaic. Debian is not."

Re:bah! (1)

SlashDotAgent (700292) | more than 10 years ago | (#8077875)

real *nix users compose man pages!

Man pages are evil... (4, Funny)

inertia@yahoo.com (156602) | more than 10 years ago | (#8077645)

It's evil because there's a deamon involved, and this command:
$ man mount

Re:Man pages are evil... (3, Funny)

Anonymous Coward | more than 10 years ago | (#8077693)

maybe you need to try these command first ...

man date

man strip

i'd leave the dollar sign out that's illegal
in most states.

Re:Man pages are evil... (0)

Anonymous Coward | more than 10 years ago | (#8077737)

Or try this:

$ man woman

Re:Man pages are evil... (5, Funny)

Anonymous Coward | more than 10 years ago | (#8077782)

Check out the complete output:
$ man woman
No manual entry for woman
How appropriate.

Re:Man pages are evil... (0)

Anonymous Coward | more than 10 years ago | (#8077746)

I think these are much worst:

$ man fsck

and

$ man jobs

Re:Man pages are evil... (2, Funny)

PowerPill (687850) | more than 10 years ago | (#8077913)

Yes and if you: $ man pump too many times you could go blind.

Re:Man pages are evil... (3, Funny)

Feztaa (633745) | more than 10 years ago | (#8077989)

Yeah, but once you learn out how to mount, you can:
$ mount /woman

A play on "The Grumpy Man" from SNL (3, Funny)

DarkHelmet (120004) | more than 10 years ago | (#8077650)

Real Linux hackers do not use man! They look at the source and figure out how the program works from the command line!

And back before we had all this open-schopen source, we had to decompile our programs so that we could figure out how it works.

And before we had fancy-shmancy C/C++, we disassembled our programs and found out how they worked from there.

And we liked it!

MOD PARENT +50 FUNNAY (-1, Offtopic)

Anonymous Coward | more than 10 years ago | (#8077669)

You are teh funniest slashdot reader evar!

Re:A play on "The Grumpy Man" from SNL (5, Funny)

Anonymous Coward | more than 10 years ago | (#8077684)

Shhh ! You're gonna wake up one of these 3 digits slashdot ID elders. And you know how they love to speak about good ol'time...

Re:A play on "The Grumpy Man" from SNL (2, Funny)

Surazal (729) | more than 10 years ago | (#8077759)

You know, back in *my* day, we didn't have these fancy-schmancy SCSI cables to help us write our data to disk. No, in my day, we had to write it down using burnt sticks we pulled from smoldering camp fires. Then we ran across the savana, burnt stick and all. And when we got to our destination to write that data to disk, when we got an error, we had to run all the way back to our camp and yell out at the top of our lungs "WRITE ERROR! CHECK CONDITION!" Then we had to run all the way back just to get the sense key data.

Beat *that*!

Re:A play on "The Grumpy Man" from SNL (0)

Anonymous Coward | more than 10 years ago | (#8077774)

Damn, I knew it...

Re:A play on "The Grumpy Man" from SNL (0)

Anonymous Coward | more than 10 years ago | (#8077803)

And when we got to our destination to write that data to disk, when we got an error, we had to run all the way back to our camp and yell out at the top of our lungs "WRITE ERROR! CHECK CONDITION!" Then we had to run all the way back just to get the sense key data.


Beat *that*!

Ok, I'll try :

Youngster ! Back in my days we didn't even have legs to run or lungs to yell ! But we were already coding DNA.

Re:A play on "The Grumpy Man" from SNL (3, Funny)

mce (509) | more than 10 years ago | (#8077839)

You already had disks to run to and write on? Jeez, I guess it shows that my 3-digit slashdot ID is considerably lower than yours. :-) Back when I started, we had to use our brain. That good ol'technology did save us a lot of useless running, though...

Re:A play on "The Grumpy Man" from SNL (1)

iminplaya (723125) | more than 10 years ago | (#8077888)

a brain???...you hadda....aaawww, nevermind

If Claudia Shiffer married The Brain, could we call her Claudia Shiffer-Brains?

Re:A play on "The Grumpy Man" from SNL (5, Funny)

Russ Steffen (263) | more than 10 years ago | (#8077901)

Ach, you kids and your "brains." When I started we had to do all our thinkin' with just a few neurons at the top of our spinal chords. And we liked it! We loved it!

Brains? Luxury...

Re:A play on "The Grumpy Man" from SNL (2)

Surazal (729) | more than 10 years ago | (#8078117)

Spinal cords!?

Ok, you know, there are some jokes that never get old. Others were born that way. Back in my day, all the jokes were old! Why, some of our jokes were so old that we would just we wouldn't have to tell the whole joke for it

Re:A play on "The Grumpy Man" from SNL (1)

niko9 (315647) | more than 10 years ago | (#8077889)

Shhh ! You're gonna wake up one of these 3 digits slashdot ID elders. And you know how they love to speak about good ol'time...

Not to worry, it's fleet enema time at the ward.

But wait, how do they get them to comply with said enema so easily you ask???

Next time you see a nurse running down the ward hallway with a boom box, that's playing that God awful GNU/RMS tune, and there are whords of old geezers running after her with their Linux powered walkers....

well kids, now you now, and it ain't pretty.

Re:A play on "The Grumpy Man" from SNL (1)

pla (258480) | more than 10 years ago | (#8077796)

Real Linux hackers do not use man! They look at the source and figure out how the program works from the command line!

You may jest, but I've had to resort to this more than a few times, for programs with badly out-of-date man pages... Happily typing along, look up feature "foo", try using the --foo=bar switch, and then wondering why the hell I end up with 206 pages of seemingly-random garbage. Messy (and slow), but 100% effective in figuring out just what "foo" does.

Apropos (no pun intended) of the actual FP, many such inaccuracies in man pages seem to involve the interaction of POSIX compliance with the familiar classic UNIX-like tools. So, with luck, this may actually mean the man pages will become a tad more accurate in the near future.

Re:A play on "The Grumpy Man" from SNL (1)

SlashDotAgent (700292) | more than 10 years ago | (#8077845)

Just like Real SlashDot hackers do not use WYSIWYG comment posting forms, but rather just write the HTML code?

Oh, wait.

Re:A play on "The Grumpy Man" from SNL (0)

Anonymous Coward | more than 10 years ago | (#8077867)

Let me guess, five miles uphill in the snow...Both ways? ;p

Hey, that's great news! (-1, Troll)

Anonymous Coward | more than 10 years ago | (#8077656)

Isn't it? I really don't know -- I downloaded Red Hat Lunix and all I know is that when I go into #linux they always tell me to read the man pages.

Down with The Man (-1, Troll)

Anonymous Coward | more than 10 years ago | (#8077657)

This is GNU/Linux, we got info so man can die the death it deserves.

The is cool (-1, Troll)

Anonymous Coward | more than 10 years ago | (#8077659)

Those Juggies are really going to do great things for the Linux community!

Who cares about the IEEE? (4, Funny)

Anonymous Coward | more than 10 years ago | (#8077676)

Do they have SCO's permission?

HHAHAHA +1000 FUNNY!! (-1, Redundant)

Anonymous Coward | more than 10 years ago | (#8077689)

LOLOL U MADE A SCO REFERENCE!!

THAT IS TEH HILARIOUS!!! ROFFELS!

Important Stuff:
Please try to keep posts on topic.
Try to reply to other people's comments instead of starting new threads.

Re:HHAHAHA +1000 FUNNY!! (-1, Offtopic)

Anonymous Coward | more than 10 years ago | (#8077721)

right on!!!

Captain's Log: My Anus is too Fucking Tight (-1, Troll)

Anonymous Coward | more than 10 years ago | (#8077682)

One day Captain Kirk was maiming his cock with a horseshoe when suddenly Mr. Spock ran up to him and shoved his pointy ear up his butt. "What is this for!" the fag captain said. "FAGS FOR YOU AALL!L!!!" the ancient alien howled as suddenly he farted and Captain Kirk twirled around in a daze and his foreskin twisted and his kidney stones turned into wooden beads. He pulled out his pistol and shot lasers at his chastity belt and suddenly he hurdled his dick into Captain Kirk"s bellybutton and it tore his flesh while Spock fucked his stomach. Kirk hollered out loud and Mr. Spock threw his shoes to the floor and wrinkled his penis until Kirk bellowed out to make it stop. A maelstom of shit whizzed around the ship and suddenly a giant fag appeared out side and the U.S.S. Enterprise went up his butt. "Oh what the hell have you gotten us into NOW!" Captain Kirk said as he oozed a condom back on his dick and put his panties back on. "OOH!H!!!!!!" Mr. Spock started fucking him again and shoved his phazer up his butt. He dissolved his glands and exploded his turds and finally a queer klingon hurdled through the door and smashed Kirk with his butt hairs. A maniac sucked his dick and suddenly Mr. Spock fagged Kirk so hard that his intestines burst open and he died.

Re:Captain's Log: My Anus is too Fucking Tight (-1, Offtopic)

Uber Banker (655221) | more than 10 years ago | (#8077810)

Yeah, TOS sucked, almost as much as TNG, but Enterprise is grrrrrrrrrreat! I hope T'Pul and Captain Archer get it on like you described, they would make me real horny.

Re:Captain's Log: My Anus is too Fucking Tight (-1, Offtopic)

Anonymous Coward | more than 10 years ago | (#8077924)

T'Pul mine she can. -- Yoda

errno.h? (0)

Anonymous Coward | more than 10 years ago | (#8077683)

so i wonder if these docs contain any SCO confidential trade secrets....

batman touched my junk liberally. (-1, Offtopic)

Anonymous Coward | more than 10 years ago | (#8077716)

batman touched my junk liberally.

WELL MOD ME DOWN!!!!!11~` (-1, Offtopic)

Anonymous Coward | more than 10 years ago | (#8077687)

Ooooh... (1)

mikeophile (647318) | more than 10 years ago | (#8077698)

So now they are going to be packed with even more manly goodness?

However... (4, Funny)

SnowZero (92219) | more than 10 years ago | (#8077705)

In return for the free content, all man pages will be required to incorporate ascii-art banner ads.

Re:However... (3, Funny)

plams (744927) | more than 10 years ago | (#8077824)

would the ads be context sensitive? you know, adapt themselves to the user's preferences?

> man mount

* Do you realise that 10% of all males *
* are GAY? * * * * K-Y-Jelly in K-mart *
* * * * only $9.95!!!1!! * * * * * * * *

NAME

mount - mount a file system

SYNOPSIS

mount [-lhV]

mount -a [-fFnrsvw] [-t vfstype] [-O optlist]
mount [-fnrsvw] [-o options [,...]] device | dir
mount [-fnrsvw] [-t vfstype] [-o options] device dir
etc..

man, that's cool! (4, Insightful)

adrianbaugh (696007) | more than 10 years ago | (#8077713)

(Ahem.) I like man chiefly because the default (command-line) browser program doesn't suck quite so much. I'm sure there are technically superior ways to store documentation, but man is very readable. info, on the other hand, blows.

Re:man, that's cool! (5, Informative)

Anonymous Coward | more than 10 years ago | (#8077733)

Try reading info pages with "pinfo" instead of "info" - you'll like info pages much more when you've got a decent viewer =)

Re:man, that's cool! (1)

adrianbaugh (696007) | more than 10 years ago | (#8077762)

> Try reading info pages with "pinfo" instead of "info" - you'll like info pages much more when you've got a decent viewer =)

Woo, thanks for the tip! That's much better.

Re:man, that's cool! (2, Interesting)

GammaTau (636807) | more than 10 years ago | (#8077936)

Try reading info pages with "pinfo" instead of "info" - you'll like info pages much more when you've got a decent viewer =)

Yeah, pinfo is definitely better than the default info viewer. The only problem with pinfo is that it's not really standard. If I log on to a system I'm not familiar with (and then I often really _need_ documentation), I can't be sure if "pinfo foo" will work whereas "man foo" will work with almost 100% certainity.

Because it is pretty much guaranteed that man pages can be read on every system without any viewer brain damage, it also leads to a situation where many people write only man pages and additional documentation in other formats (like plain text or HTML). I know that info can view man pages when info pages are not found but I rarely bother. I just use "man foo" and if that doesn't give what I'm searching for, then check /usr/share/doc or search the web.

Not so fast ... (-1, Offtopic)

zangdesign (462534) | more than 10 years ago | (#8077736)

Have they cleared this with SCO?

bwahahhaahhhahhaaaahhahahahaaaahaha!

I slay me! With a +10 vorpal sword of slaying me!

Typical GNU utility man page... (4, Funny)

compass46 (259596) | more than 10 years ago | (#8077742)

$ man cp

"The UNIX man page system sucks. Use the info system instead."

so...

$ info cp

"The UNIX man page system sucks. Use the info system instead."

Re:Typical GNU utility man page... (4, Informative)

petabyte (238821) | more than 10 years ago | (#8077780)

Umm, both my slackware and gentoo boxes have a full man page for cp. Apparently they're from the fileutils package.

I'd suggest everyone load up the funny-manpages and asr-manpages if you're bored.

man lart

No more see info? (4, Interesting)

zsau (266209) | more than 10 years ago | (#8077748)

Does this mean no more cruel messages telling us to see the info pages?

Re:No more see info? (1)

myc_lykaon (645662) | more than 10 years ago | (#8077910)

Does this mean no more cruel messages telling us to see the info pages?

I sincerely hope so. The info pages are about as much use as a handbrake on a canoe. I'm very surprised that the info page writers ignored the 'those who seek to re-invent the wheel are doomed to do so badly' adage.

If one more.. (2, Funny)

Anonymous Coward | more than 10 years ago | (#8077754)

If one more Slashbot makes a "DO U HAVE SCO'S PERMISSION? LOL" reference, I will touch your junk liberally.

Woot (1, Insightful)

Dark Lord Seth (584963) | more than 10 years ago | (#8077756)

Now if only GNU software would stop forcing that damnable alternative "info" ( which makes about as much sense as women ) down everyone's throath, things would be nice and happy.

GNU info sucks. (1, Troll)

Cryptnotic (154382) | more than 10 years ago | (#8077842)

Damn, the GNU-gestapo modded you flamebait already.
Oh well, I have to agree with you. GNU info sucks.

Re:GNU info sucks. (1)

AuMatar (183847) | more than 10 years ago | (#8077887)

Can someone tell me the point of info? I understand that it might be useful to have links to other utilities documentation, or split up the documentation into subcatagories, but do we really need info to do that? Why not just HTML and your favorite browser?

Re:GNU info sucks. (2, Funny)

adrianbaugh (696007) | more than 10 years ago | (#8078010)

While GNU's perfectly within its rights to call their own creation GNU/info they were getting laughed at too much when they tried to insist on GNU/HTML :-)

Re:Woot (0)

Anonymous Coward | more than 10 years ago | (#8077871)

ha! women I understand, but info *shrug*

[dog@linux:/home]$ man weiner (Sc ore:5, Funny) (-1, Troll)

Anonymous Coward | more than 10 years ago | (#8077758)

SURE THEY LOOK CUTE BUT DID YOU KNOW
THE AVERAGE WEINER DOG CAN SUCK ITS
OWN WEIGHT IN COCKS AND THEREFORE AIDS
__
, ," e`--o
(( ( | __,'
\\~----------------' \_;/
poo ( /
/) ._______________. )
(( ( (( (

Meh. (0)

Anonymous Coward | more than 10 years ago | (#8077760)

Doesn't matter, the free BSD projects have always had better man pages than Linux.

How useful is this? (4, Interesting)

A nonymous Coward (7548) | more than 10 years ago | (#8077785)

Most man pages have long since been written from scratch for Linux. It would seem that any man pages still missing must be pretty rarely used, or for obsolete commands.

There are differences between UNIXes and Linux distributions and BSD distributions. What do the POSIX man pages document, and is it more trouble than it is worth to use them as a basis for Linux man pages?

I really don't know, this is not a troll, I didn't even know that there were POSIX man pages.

Re:How useful is this? (4, Informative)

dietz (553239) | more than 10 years ago | (#8077904)

I really don't know, this is not a troll, I didn't even know that there were POSIX man pages.

There are no POSIX man pages. But previously they weren't allowed to even quote the POSIX standard in their manpages. They had to rewrite it all and hope they didn't introduce any inaccuracies in their rewriting.

Now they can just quote the standard itself where they want to.

This is mostly important for programming documentation (e.g. "man 3 strerror")

Yeah, but... (5, Funny)

inertia@yahoo.com (156602) | more than 10 years ago | (#8077797)

They still need to improve the hideous grammar of the man pages:
$ man nothing
No manual entry for nothing

Has anyone here tried to write man pages? (5, Interesting)

Pyromage (19360) | more than 10 years ago | (#8077806)

I see a lot of people bitching about how info sucks. Well, you know what? Maybe it does. But have you actually tried to write a man page?

The syntax for roff just sucks. Info, on the other hand, is a fairly reasonable way to write documentation.

Re:Has anyone here tried to write man pages? (1)

Meowing (241289) | more than 10 years ago | (#8077852)

The pod2man tool that comes with Perl makes the process relatively painless. POD isn't really Perl-specific, it works well to build standalone documentation.

What I like about 'man' (1)

baywulf (214371) | more than 10 years ago | (#8077961)

You can generate postscript output for printing like this for example:

man -t ls

Don't know if this can be done with info?

Re:Has anyone here tried to write man pages? (1)

adrianbaugh (696007) | more than 10 years ago | (#8078022)

It does, but on the other hand it's fairly easy to take an existing man page, rip out all the content and replace it with your own. I did that for a small application I wrote when I couldn't be bothered to learn roff syntax properly and, although it's a bit of a cop-out, it's easy enough.

Re:Has anyone here tried to write man pages? (1)

Walterk (124748) | more than 10 years ago | (#8078028)

As a writer of two (1 [sourceforge.net] , 2 [sourceforge.net] ) man pages, I can say that I find the syntax of roff not that bad. I guess you get used to strange languages once you learn more of them. If you find roff hard, try writing Perl scripts without any alphanumerical tokens.

Use POD and pod2man (2, Informative)

barries (15577) | more than 10 years ago | (#8078036)

Yeah, it's trival: use POD. And pod2man. Or any other format you want (po2html, pod2text, etc) on almost any system with Perl on it. And integrate it in to your program as online help. And usage. And and and...

Use the right tool, don't let the wrong tool use you.

- Barrie

Re:Has anyone here tried to write man pages? (1)

ncc74656 (45571) | more than 10 years ago | (#8078085)

I see a lot of people bitching about how info sucks. Well, you know what? Maybe it does. But have you actually tried to write a man page?

I have. The markup used by man ([gnt]roff -man, really) isn't that complicated. If you've ever used a non-WYSIWYG word processor or written your own HTML, throwing together a manpage shouldn't be that difficult to figure out. You should be able to figure out enough to get by just by looking at the system-provided manpages.

Who uses man anymorE? (0)

Anonymous Coward | more than 10 years ago | (#8077814)

favorite man command (0)

gearheadsmp (569823) | more than 10 years ago | (#8077855)

I've heard the following command is popular in some places:
$ man fsck

Many man pages were already direct copies (1)

Fefe (6964) | more than 10 years ago | (#8077856)

This is obviously a good thing to do for the Open Group. I wonder, though, why they say they grant the permission to the Linux Man Page Project. Their documents are freely redistributable anyway, so this in effect gives the content away.

Many Linux man pages were already direct or very close copies, any the BSD man pages are also very close. And why wouldn't they? The content is quite formulaic and there is not much space for exploring language creativity, it's technical documentation after all.

wtf? This wasn't automatic? (4, Interesting)

visualight (468005) | more than 10 years ago | (#8077859)

The most interesting point of this story is that the entire planet wasn't given permission to reprint the posix standard from day one. It's a standard isn't it?

Isn't promoting standards one of the main reasons for the IEEE consortium's existance? How do you promote standards by not allowing anyone to reprint them?

And the Linux Man Page Project expresses how grateful they feel. Whatever.

Re:wtf? This wasn't automatic? (4, Informative)

vidarh (309115) | more than 10 years ago | (#8077971)

Many standards organisations survive to a large extent on income generated by selling copies of the standards documents. It's only in recent years started becoming common for standards documents to be available free. Still, even now most ANSI and ISO standards for instance still costs money.

Re:wtf? This wasn't automatic? (2, Interesting)

CRCulver (715279) | more than 10 years ago | (#8078055)

Standards, when published in print, are often sold for a heck of a lot of money. Take for instance the Unicode standard. It's an open standard, and quite important for internationalisation in our digital age, but you'll pay $74 to get it. When Linus was developing Linux, he had to get his POSIX information through Minix because it was too expensive to go right to POSIX.

Good, (2)

noselasd (594905) | more than 10 years ago | (#8077886)

Does that mean well get some docs on the pthreads rwlocks and posix semaphores ? Just yesterday I needed them, and sadly discovered they were missing ,(

Could this mean... (2, Informative)

rhythmx (744978) | more than 10 years ago | (#8077894)

the beginnings of Linux-3.0.0??? from Linux kernel readme:
WHAT IS LINUX? Linux is a Unix clone written from scratch by Linus Torvalds with assistance from a loosely-knit team of hackers across the Net. It aims towards POSIX compliance.
The next major version will be released when the new kernel will break support for almost all existing binaries. If all the kernel interfaces are tweaked and made to be posix compliant. We may be seeing the Linux-3.0.0 soon!

Certain interesting pages: (0)

Anonymous Coward | more than 10 years ago | (#8077905)

man drake
man date
man atee
man tego
man ohman
man dennishopper_man

I use Gentoo... (0)

Anonymous Coward | more than 10 years ago | (#8077935)

how does this affect me?

Remind me again...? (0)

Anonymous Coward | more than 10 years ago | (#8077964)

What does "POS" stand for?

What are Man pages? (1, Funny)

Omega1045 (584264) | more than 10 years ago | (#8077991)

I don't understand what these "Man" pages are? Is this some sort or web pages of porn for women, is it gay? Is this trendy? Should I "like" or "groove" on "Man" pages?
Load More Comments
Slashdot Login

Need an Account?

Forgot your password?