Beej's Guide to Network Programming

This is the source for Beej's Guide to Network Programming.

If you merely wish to read the guide, please visit the Beej's Guide to Network Programming website.

This is here so that Beej has everything in a repo and so translators can easily clone it.

Build Instructions

Dependencies

• Gnu make (XCode make works, too)
• Python 3+
• Pandoc 2.7.3+
• XeLaTeX (can be found in TeX Live)
• Liberation fonts (sans, serif, mono)

Mac dependencies install (reopen terminal after doing this):

xcode-select --install                  # installs make
brew install python                     # installs Python3
brew install pandoc
brew cask install mactex                # installs XeLaTeX
brew tap homebrew/cask-fonts
brew cask install font-liberation-sans  # installs sans, serif, and mono

Build

1. Type

   make

   from the top-level directory.

If you have Gnu Make, it should work fine. Other makes might work as well. Windows users might want to check out Cygwin.

1. Type

   make stage

   to copy all the build products and website to the

   stage

   directory.

2. There is no step three.

You can also

cd

src

make

make clean

make pristine

To embed your own fonts in the PDFs, see the

src/Makefile

The

upload

Makefile

UPLOADDIR

Makefile

Build via Docker

If you don't want to mess with a local setup, you can build via Docker.

1. Run

   docker build -t beej-bgnet-builder .

   from the top-level directory.

2. Run

   docker run --rm -v "$PWD":/guide -ti beej-bgnet-builder

   .

This will mount the project where the image expects it, and run

make
   pristine all stage

./stage

Pull Requests

Please keep these on the scale of typo and bug fixes. That way I don't have to consider any copyright issues when merging changes.

TODO

Content

• File transfer example maybe in son of data encapsulation
• Multicast?
• Event IO?

Bug fixes

• When pandoc 2.8 comes up, switch all man page subheaders to h3 and supress them from the table of contents.