Live data from Hacker News

Bro pages: like man pages, but with examples only

bropages.org

411–420 of 872 posts

Re: Bro pages: like man pages, but with examples only

#413
post #99

Great idea; shame about the name. Here's the problem with using words like "bro" (however jokingly): the problem is not with what you [0] are thinking when you read the word "bro", but with what other people , especially newcomers, are thinking. The locker-room atmosphere that stuff like this creates is a huge barrier to entry for a lot of people, women especially, who infer that on top of all the technically difficu…

I'd have named them "spartan" pages.

The name is a LOT more sexist, but few people would realise (spartans famously didn't think highly of wom¹), but it also has the metaphorical meaning of being b¹-bones, which is what these pages are. But that name is seven whole letters and that's harder to type than m¹, so I'd abbreviate it to sprn, which also stands for sy¹ pn¹, both of which are way, way more sexist than b¹.

¹ censored for your protection - ED

The only way to fight moralfags is to make your product so outrageously sexist, no-one can tell it's actually sexist. Kind of like how Matt Stone and Trey Parker got the jokes in the South Park movie past the censors - each time a joke would be rejected, they'd censor/change it in a way that made it even dirtier. No-one caught onto the fact that "bigger, longer and uncut" is a dick joke.

Re: Bro pages: like man pages, but with examples only

#414
post #5

Here's a nickel kid, go buy an operating system with decent man pages.

Man pages are nice sometimes but oftentimes they have a lot of options and no examples. For advanced usage of some commonly used commands it's far easier to just look it up online, or perhaps with this tool. Example good man page is ps, and an example difficult to use one is gcc. Even though the gcc man page has all the options, it's very difficult to figure out which ones you need, whereas something like this (or co…

My pet hate is man pages where the tool has a lot of options, and in the manual the options are listed neither alphabetically nor by semantic grouping. "Hrm, what does '-l' do. I guess I'll search for it, and hit every other -l along the way..."

Re: Bro pages: like man pages, but with examples only

#415

If you are getting that upset about the use of the word bro you have bigger problems

Actually no. Perpetuating the "boys only" impression many programmers seem to want to cultivate is bad. The name is exclusionary, and a poor joke.

if you see naming a tool with a clever play on the command "man" as perpetuating a "boys only" culture you almost certainly need more human-to-human interaction away from the computer and away from tumblr or whatever terrible place has brainwashed you.

Re: Bro pages: like man pages, but with examples only

#416
post #4

Is the "bro" intended to be ironic, or are the creators actually not aware that the term is used to represent the worst (most misogynistic, most crass, least mature, least dependable) people currently flocking to the industry? It is by its very definition exclusionary. I suppose "brogrammers" might be a target audience, but the concept of the tool itself is pretty good for just about anyone. Shame about the name.

I figured it was called bro because brogrammers maybe don't care about how anything works - they just want the answer..?

Anyway, I think this looks to be an awesome utility. People often smugly refer another programmer to use man. But many times man is not actually very helpful for common use cases because it shows way too much - including every possible option without highlighting the 1 or 2 that are commonly used. The man page may use terminology that doesn't make sense if the user is not already familiar with the command.

It's definitely helpful and people should use man, but there are definitely times when a 1 line example will tell you more than 10 man pages. bro looks like a great compliment to that.

Shit name, though, it would make more sense if it was something relatable to "example"

Re: Bro pages: like man pages, but with examples only

#419

Earlier quoted context omitted.

I am not offended on anyone else's behalf, but am personally offended, and I am a man. Don't pretend I don't exist because it's inconvenient to your worldview.

You're offended because someone used the word bro. You must be a hit at parties.

You should remember that there are actual people behind the words on your screen before you say something awful like this. This is not very nice.

Another thing I'd point out is that there is a huge number of women who feel the same way. Rather than simply asserting they are all emotionally incontinent, you should ask yourself whether there is something about the experience of being a female programmer who feels like an outsider that you do not understand. (I am betting you are a man, but if you are a woman, I actually still stand by this.)

I say this, overgard, because I assure you that if you talk to people who are offended you will find that most of them are reasonable people who want to talk about this in a reasonable fashion. Not just oversensitive sissies who are looking for things to be offended about.

Re: Bro pages: like man pages, but with examples only

#420
I think it's a real shame that the whole discussion here seems to be about the name the author chose for this project, rather than the actual project. Surprisingly, the discussion on Reddit seems to be much more constructive and interested in talking about the project itself.
Post reply on HN