When you have a document like:
animal.bigb
= Animal
== Dog
=== Poodlethe version without
-S, --split-headers will contains a valid ID within it:animal.html#poodleHowever, if at some point you decide that the section
dog has become too large and want to split it as:= Animal
\Include[dog]and:
dog.bigb
= Dog
== PoodleWhen you do this, it would break liks that users might have shared to
animal.html#poodle, which is not located at dog.html#poodle.To make that less worse, if
-S, --split-headers are enabled, we check at runtime if the ID poodle is present in the output, and if it is not, we redirect to the split page #poodle to poodle.html.It would be even more awesome if we were able to redirect to the non-split version as well,
dog.html#poodle, but that would be harder to implement, so not doing it for now.