diff options
Diffstat (limited to 'data/doc/sisu/sisu.org')
-rw-r--r-- | data/doc/sisu/sisu.org | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/data/doc/sisu/sisu.org b/data/doc/sisu/sisu.org index 265abda9..64246368 100644 --- a/data/doc/sisu/sisu.org +++ b/data/doc/sisu/sisu.org @@ -2247,22 +2247,22 @@ consider, I have to date deliberately tried to keep it easy to follow documents & not have too much depth ... The idea of recursive includes is un-attractive (messy for a document) -.ssm currently can contain .sst or .ssi +.ssm currently can contain/include .sst or .ssi .sst files can be processed independently, -.ssi files are only insertions & cannot +.ssi files are only insertions & are not processed independently but as part of an ssm -allowing .ssi to also include other .ssi or .sst could lead to recursive .ssi -allowing .ssm to also include other .ssm .ssi or .sst could lead to recursive .ssm +change proposed +.ssm unchanged +.sst unchanged +.ssi as before, but can include .sst or .ssi, so: + files are only insertions & are not processed independently but as part of an .ssm or another .ssi + i.e. as before with the addition that it like a .ssm can contain/include .sst or .ssi -stopping after an additional level of includes seems arbitrary, and possibly prone to error if you are dealing with many documents +this is pretty much as requested by wishlist 744408 -a possibility would be to have another file extension to flag the role of the file, -.ssmi (not very attractive) might do it -(providing visual cue signalling its role as both a master file and an insertion/included file that cannot be processed independently) -a .ssmi file must be included in a .ssm file -a .ssmi file (like .ssm) permits the inclusion only of .sst or .ssi files +allowing .ssi to also include other .ssi or .sst could lead to recursive .ssi -will work on eventually +stopping after an additional level of includes seems arbitrary, and possibly prone to error if you are dealing with many documents **** TODO [#C] #744409 [w|u] sisu output: urls in code blocks are not linkified <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=744409> |