Skip to content

Commit

Permalink
add FAQ about single-header-file libs
Browse files Browse the repository at this point in the history
  • Loading branch information
nothings committed Feb 1, 2015
1 parent 4b518bb commit bdef693
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 0 deletions.
14 changes: 14 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,20 @@ attribution requirement). They may be less featureful, slower,
and/or use more memory. If you're already using an equivalent
library, there's probably no good reason to switch.

#### Why single-file headers?

Windows doesn't have standard directories where libraries
live. That makes deploying libraries in Windows a lot more
painful than open source developers on Unix-derivates generally
realize. (It also makes library dependencies a lot worse in Windows.)

Making them a single file makes it very easy to just
drop them into a project that needs them. (Of course you can
still put them in a proper shared library tree if you want.)

The difference between 10 files and 9 files is not a big deal,
but the difference between 2 files and 1 file is a big deal.

#### Why "stb"? Is this something to do with Set-Top Boxes?

No, they are just the initials for my name, Sean T. Barrett.
Expand Down
14 changes: 14 additions & 0 deletions tools/README.footer.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,20 @@ attribution requirement). They may be less featureful, slower,
and/or use more memory. If you're already using an equivalent
library, there's probably no good reason to switch.

#### Why single-file headers?

Windows doesn't have standard directories where libraries
live. That makes deploying libraries in Windows a lot more
painful than open source developers on Unix-derivates generally
realize. (It also makes library dependencies a lot worse in Windows.)

Making them a single file makes it very easy to just
drop them into a project that needs them. (Of course you can
still put them in a proper shared library tree if you want.)

The difference between 10 files and 9 files is not a big deal,
but the difference between 2 files and 1 file is a big deal.

#### Why "stb"? Is this something to do with Set-Top Boxes?

No, they are just the initials for my name, Sean T. Barrett.
Expand Down

0 comments on commit bdef693

Please sign in to comment.