Hey, I recently had to run rocco against some HTML files to generate documentation from the Markup in them.
I used:
To my surprise, rocco replaced all of the HTML files I wanted to document with the documentation generated.
In hindsight, I should have predicted that this would happen, since rocco replaces the input file extension with html and overwrites the existing content. Luckily, I had everything backed up, so this wasn't an issue.
I would like to suggest that rocco either rejects html files without the -o flag, issues a massive warning about potential data loss or writes the resulting documentation to *.html.html files, just in case.
Thanks.
On a side note, running rocco index.html multiple times and watching the file size grow exponentially is kind of fun. After 4 steps, I already had a 10MB html file, with escape sequeces escaped with escape sequences escaped with escape sequences escaped with escape sequences escaped with escape sequences.