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.
Hey, I recently had to run
roccoagainst some HTML files to generate documentation from the Markup in them.I used:
To my surprise,
roccoreplaced all of the HTML files I wanted to document with the documentation generated.In hindsight, I should have predicted that this would happen, since
roccoreplaces 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
roccoeither rejects html files without the-oflag, issues a massive warning about potential data loss or writes the resulting documentation to*.html.htmlfiles, just in case.Thanks.
On a side note, running
rocco index.htmlmultiple 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.