# install bro now
$ gem install bropages

bro pages are a highly readable supplement to man pages
bro pages show concise, common-case examples for Unix commands

example

If you type...

$ bro curl

...then you get

2 entries for curl -- submit your own example with "bro add curl"

# get the contents of a web page
curl http://bropages.org

        bro thanks      to upvote (2)
        bro ...no       to downvote (0)

...............................................

# send a header with curl
curl --header "X-MyHeader: 1" www.bropages.org

        bro thanks 2      to upvote (1)
        bro ...no 2       to downvote (0)

add an entry to bro

adding an entry is easy with the bro CLI!

bro add curl

typing bro add cmd will launch your system editor, allowing you to submit an entry

installing bro

The bro CLI is a Ruby Gem and can be installed as follows

gem install bropages

bro is meant to work out of the box for any machine running Ruby 1.8.7+

updating bro

we push code quite frequently, thus your bropages gem may get out of date occasionally. however, updating is easy, simply type:

gem update bropages

community

bro sources its entries from the community, bropages.org hosts all the entries
Entries can be voted up or down, and the best entries are what people see first when they use the bro command line interface
For example, here are the top entries on bropages.org:

Command Entry Votes
bro
# lookup an entry for the command 'bro' with bro
bro bro
146   4
tar
# Create a tar archive
tar -cf archive.tar file1 file2 ... fileN

# Create a tar gzipp'd archive
tar -zcf archive.tar.gz file1 file2 ... fileN

# Create multi-part tar archives from a directory
tar cf - /path/to/directory|split -b<max_size_of_part>M - archive.tar

# Extract all files from a tar archive
tar -xf archive.tar

# Extract all files from a tar gzipped archive
tar -zxf archive.tar.gz

# Extract one file from a tar archive
tar -xf archive.tar the_one_file

# Lists all files in a tar archive
tar -tf archive.tar
90   0
ln
# Creates a soft link
ln -s /full/path/to/original/file /full/path/to/link

# Creates a hard link
ln /full/path/ln/original/file /full/path/to/link
69   0
curl
# get the contents of a web page
curl http://bropages.org
67   5
curl
# download a file and write it to another file called myfile.html
curl -o myfile.html http://bropages.org
37   0


Browse all  

irc channel

join us at #bropages on freenode!