Stefan, Thank you and my apologies for the long delay in response, somehow I missed your report.
Thus spake Stefan T. (won...@xdn.de): > Package: sisu > Version: 0.71.4-1 > Severity: normal > When I invoke 'sisu -an' it generates a textfile with appendix > "DOCUMENT INFORMATION (METADATA)". > > But I used both parameters '-n' and '-a' extra to avoid this, as it is > explained in manpages: > > -a: produces plaintext with Unix linefeeds and without markup -n: skip > meta-markup > The short answer is: your submission is not a bug in the applications behavior, but rather; but a bug or a failure of clarity on my part in the man pages describing the behavior of -n (was not programmed to have the behavior you expect). I will attempt to make the description of the behavior -n clearer in the in the man pages and other documentation. It should probably read more along the following text: "-n skips the creation of intermediate processing files if intermediate processing files already exist." With some apologies for the length and being off-topic in relation to the feature you desire, here is what -n does, (and an explanation of th odd language used to describe it): sisu generates documents in two steps first, it produces a processing file (that i originally described as meta-marked up, i am now more inclined to describe as a document abstraction, but this is in fact just an interim processing document) that is used by various output format generation modules. It is a necessary step to produce a various output formats; -m ensures that it is performed, but it is usually assumed as necessary by the program. However, sisu additionally produces a marshalled version of these interim processing files, which if they still exist can be used to generate various output formats that are downstream of the interim processing files, skipping the re-creation of an interim processing file (the -m step). You might want this if you first produce one form of output, e.g. -a (plaintext) and subsequently decide to produce html, and decide you would rather skip re-generating the interim processing files, (possibly as it saves a bit of time). You do not want to use it if you have made changes to your document as these will not appear, the old or pre-existing interim processing files are used. (Whilst on the subject the marshalled documents are used in batch processing where many documents are processed first for one output file format type then the next, otherwise it would have been necessary to create the same interim processing files for each step. The processing files by default are written to the /tmp/sisu/username directory, however as this might result in privacy issues they may be redirected in the config file) Now what you wish may be a feature that should be added, at least for plaintext output. > I suggest that the function of parameter "-n" is corrected in order to > generate a text-file without any headers or meta-markups. > Rather I will attempt to make clearer (correct) the description in the man pages and other documents as to the expected behavior for -n (and I would intend at that time to close this bug) The feature you desire could be submitted as a wishlist/feature request, though will not get my immediate attention. Would the flag you request apply only to plain text files, if so a different parameter may be used to be added only to -a, e.g. --without-metadata Again thank you. Sorry I do not have an answer that satisfies your wish directly. Sincerely, Ralph Amissah > > -- System Information: > Debian Release: squeeze/sid > APT prefers testing > APT policy: (890, 'testing'), (850, 'stable'), (845, 'unstable'), (800, > 'experimental') > Architecture: amd64 (x86_64) > > Kernel: Linux 2.6.26-2-openvz-amd64 (SMP w/1 CPU core) > Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8) (ignored: > LC_ALL set to de_DE.UTF-8) > Shell: /bin/sh linked to /bin/dash > > Versions of packages sisu depends on: > ii libruby [libwebrick-ruby] 4.2 Libraries necessary to run Ruby > 1. > ii rsync 3.0.6-1 fast remote file copy program > (lik > ii ruby 4.2 An interpreter of > object-oriented > ii unzip 6.0-1 De-archiver for .zip files > ii zip 3.0-1 Archiver for .zip files > > Versions of packages sisu recommends: > ii hyperestraier 1.4.9-1.4 a full-text search system for > comm > ii imagemagick 7:6.5.5.3-1 image manipulation programs > ii keychain 2.6.8-2 key manager for OpenSSH > ii librmagick-ruby 2.11.1-1 ImageMagick API for Ruby > ii libruby [librexml-ruby] 4.2 Libraries necessary to run Ruby > 1. > ii openssh-client 1:5.1p1-8 secure shell client, an > rlogin/rsh > ii openssl 0.9.8k-5 Secure Socket Layer (SSL) binary > a > ii sisu-pdf 0.71.4-1 dependencies to convert SiSU > LaTeX > ii sisu-postgresql 0.71.4-1 SiSU dependencies for use with > Pos > ii sisu-sqlite 0.71.4-1 SiSU dependencies for use with > SQL > ii tidy 20081224cvs-1 HTML syntax checker and > reformatte > ii vim-addon-manager 0.4.1 manager of addons for the Vim > edit > > Versions of packages sisu suggests: > ii cvs 1:1.12.13-12 Concurrent Versions System > pn kdissert <none> (no description available) > pn lv <none> (no description available) > pn pinfo <none> (no description available) > pn texinfo <none> (no description available) > pn trang <none> (no description available) > > -- no debconf information > > > -- email: ralph.amis...@gmail.com SiSU: http://www.jus.uio.no/sisu
signature.asc
Description: Digital signature
