]ANN[ Vellum 0.16: Lots Of Documentation and Watching

[Zed A. Shaw]

Hi Everyone,

Just putting out an announcement that I've released a new version of
Vellum numbered 0.16. This version should be ready for people to use
as not much of the internal structure has changed in a great many
commits and it contains all the latest bug fixes.

It also has the beginning of an extensive PDF document describing how
to use it. This is still an in-progress work, so it has grammar
mistakes and spelling errors, but it does show off some nice
documentation wizardy I'm experimenting with in LaTeX.

Finally there's a new "watch" feature which is very handy described
further down. It simply watches a file and reruns your targets when
the file changes.
GETTING IT

Honestly, the easiest way is just:

sudo easy_install zapps vellum

If you want to build the book yourself and have all of TeX Live
installed then you'd also need:

sudo easy_install pygments idiopidae

You can also hit the http://launchpad.net/vellum/ page to grab source
tarballs and other goodies.
THE BOOK OF VELLUM

You can grab the most recent draft of the book at:

http://zedshaw.com/projects/vellum/manual-final.pdf

Any corrections or comments on how it is written are more than
welcome. Suggestions for improving the TeX are also helpful since I'm
not a TeX expert yet.

The software I'm using to build that book is fully available to anyone
looking to document their projects. You can grab Idiopidae, Pygments,
and TeX from the interwebs. You can then grab the whole source and all
the LaTeX goodness from my Bazaar repository:

bzr pull http://zedshaw.com/repository/vellum/

Look in the doc/ directory for all the fun. You'll notice that
the .tex files have *no* code in them, and that it's all imported by
Idiopidae. Look at the doc/book.vel file to see how it's all merged
and massaged together, and you can reuse this book.vel file to start
your own books.
CRAZY NICE WATCH FEATURE

I added a feature to Vellum that is one of those "duh" features. You
can tell Vellum to watch a file, and if it changes Vellum will rerun
some targets. When I work on the manual.tex file, I do this:

vellum -w doc/manual.tex book.draft book.view

It just keeps looping, and if you hit CTRL-C you can force a build with
ENTER or quit with CTRL-C. Then I use the evince PDF viewer under
linux, which has similar Vim key bindings and reloads the PDF when it
changes.

The net effect of this is, whenever I change my manual.tex file, Vellum
runs my build for the manual and evince redisplays it for me to see.

You could use this simple feature to also continually run unit tests
whenever a file changes that you are working on.

GPLv3?

How do people feel about Vellum's GPLv3 status? It actually doesn't
impact anyone unless you embed Vellum into a project/product or you
create commands (which you should give back anyway). Even then if you
never release your build to your users then you don't need to release
the commands.

However, I'm curious to get other people's thoughts.

Thanks a bunch folks.

--
Zed A. Shaw
- Hate: http://savingtheinternetwithhate.com/
- Good: http://www.zedshaw.com/
- Evil: http://yearofevil.com/

[Carl Banks]

On Apr 29, 3:51 am, "Zed A. Shaw" <zeds...@zedsha w.comwrote:

GPLv3?

How do people feel about Vellum's GPLv3 status?

It's going to scare away some folks.

Using LGPL will almost certainly scare away fewer. People who don't
like GPL are usually concerned about its viral aspects moreso than the
requirement to contribute back released changes.

Carl Banks

[hdante]

On May 5, 3:26*pm, vivai...@gmail. com (Ville M. Vainio) wrote:

"Zed A. Shaw" <zeds...@zedsha w.comwrites:

GPLv3?

How do people feel about Vellum's GPLv3 status? *It actually doesn't
impact anyone unless you embed Vellum into a project/product or you

Yeah, but it effectively prevents people from embedding it into their
apps that wish to remain BSD/MIT clean.

That's not a good argument. "GPL has the problem that if people don't
want to use GPL, then they can't use the GPL'd code."

GPL can mix with other free software licenses, so people who write
BSD code and do not wish to remain BSD clean are free to use GPL'd
code. That's the important point.

>
It's not likely that some evil corporation is going to hijack Vellum
source code as a basis of their next evil app (which is basically what
GPL is used to prevent) any time soon, so I don't really see a
particular reason for such a developer-oriented tool to be released
under GPL.

Viral licenses only serve that purpose ("protecting from evil
corporations"). If he licensed Vellum with GPL in the first place,
he's worried about that.

>
Basically, avoiding GPL maximizes the brainshare that a small-ish tool

True, but you may never ever see the brilliant result of that
brainshare work. Thus, for the author, your sentence is false.

is going to attract, and many (including myself, FWIW) view GPL as a

How many ?

big turn-off when I consider spending some time to familiarize myself
with a tool, or recommending it to someone else.

[Paul Rubin]

vi******@gmail. com (Ville M. Vainio) writes:

if the idea is to maximize the popularity, GPL is a worse bet.

That is not a valid inference. Look at the popularity of Linux vs
BSD, for example.

[Paul Rubin]

"Zed A. Shaw" <ze*****@zedsha w.comwrites:

How do people feel about Vellum's GPLv3 status?

I'm certainly in favor of it, though I didn't notice this question
until it spawned its own thread, and I'm not currently a Vellum
user or developer, so maybe my view shouldn't count for much.

[Ville Vainio]

On May 6, 11:27 pm, hdante <hda...@gmail.c omwrote:

GPL can mix with other free software licenses, so people who write
BSD code and do not wish to remain BSD clean are free to use GPL'd
code. That's the important point.

No, it can't. It can only mix through aggregation, i.e. you can ship a
GPL'd "plugin" with BSD code as long as you don't import the plugin
directly.

Here's a real life example from ipython:

- Core IPython is BSD clean, and we intend to leave it that way
- If we imported a gpl'd module in some core ipython component, the
core component would be gpl (or something equally restrictive) as
well, through viral nature of the license
- Now, if you want a BSD-clean version of ipython (say, to embed it in
a commercial program - with which I have absolutely *no* problem, and
can only see good things coming from it), you would have to gleam out
all the uses of that module from the source code. Not very fun, esp.
if it's something important
- There is a GPL'd module in "extensions " folder of IPython, ipy_bzr
(that is because of bzrlib). It's never imported anywhere in ipython
source code, but the user can import it in ipy_user_conf.p y. This
"contaminat es" the config file and subsequently ipython (because it's
imported into python interpreter ipython is running on), but luckily
the user can opt out from importing it if he wishes to remain BSD
clean. Or he can delete the file altogether if he wishes.

Without GPL, none of this hair-splitting is necessary.

I guess I could have gone the Carl Banks route and just say "It scares
away some people". Consider my replies here an elaborate way of saying
the very same thing.