tags 974724 + wontfix thanks Hi
> And who decided to put dozens of separate tools into monster packages? That was a decision back 15 years ago on debian-devel, where I asked whether we should package each TeX Live package into a single Debian package or make groups according to the collections of TeX Live. So, please go back to the archives and search for an email of me proposing to package TeX Live, must be about 15 years ago. > Pre-Condition: As a regular user, I want to use a simple tool to merge > (join, concatenate, append...) a couple of existing PDF files. I don't > want to learn Latex language, my PDFs dont have much to do with Latex. Then why don't you use a tool that doesn't use LaTeX, but maybe something else, like pdftk? > First, what is texdoc anyway? > > $ man pdfjam | grep texdoc Did I send you that command line? I would normally expect that someone using Debian and has considerabl experience, is aware that the correct invocation is man texdoc ? > A regular user has no idea about this command. Why should we even care? Well, at least in the TeX World it is well known. > Even if the user knows learned this somehow by accident, your command > opens a browser, which wants me to open the MD file in a special editor > which is totally inappropriate. I guess you call sensible-browser there? That is a problem with your mime-type setup, and nothing I can influence. Look into your mime type associations for .md files. This is user controlled. > If so, why do you that for non-HTML contents? This does not make sense. > Why not use sensible-pager? Or "see"? It uses xdg-open. > > texdoc pdfpages > > gives you the documentation of the additional key/value pairs accepted. > > No, it doesn't. Well ... because ... > Okay, with some luck (and knowledge how to use apt-file) one can find: > texlive-latex-recommended-doc: > /usr/share/doc/texlive-doc/latex/pdfpages/pdfpages.pdf Which you didn't install, right? Despite being a Recommends Sorry, it is up to you if you override the recommendations of the maintainers to deal with the outcome. > So even after all that guessing one has to install FIFTY megabytes of > docs to learn about a couple of command line options of a simple tool > which does not even have obvious relationship to Latex in the first > place? SERIOUSLY? Feel free to use the link to CTAN to only read the one document. > And then even when going the hard way with pdfpages docs, it's not > perfectly clear how exactly to convert those documentation into pdfnup > command line options. It is, pdfjam clearly states that the KEYS are the key=value pairs from pdfpages manual. > And by the way, if this is the way to go (which I doubt) then that way > should be documented in /usr/share/doc/texlive-extra-utils/README.Debian > somehow. Is it? Hardly, IMHO. And what do find there instead? What should be documented? Maybe If you choose to not install documentation packages which are recommended, don't you wonder that you might miss something? Or something similar? Ok, I pose you a good question: Please come up with a better way to provide 2.9G (!!!) of documentation, that is what TeX Live is shipping. Make a decent proposal, and send pull requests to the packaging infrastructure at github.com/debian-tex/ I am anxiously waiting. > Why should I expect that? I didn't ever care about what it uses > underneath. I expect it, like any other tool, to document ITS OWN BASIC > operations properly. If that's is too complicated to be stored in a Please bring this up to the author of pdfjam. The TeX Live Debian Team packages what TeX Live ships. TeX Live includes what authors ship. We only accept bugs that are related to Debian packaging or upstream = TeX Live, but not for bugs that are in single packages (= up-upstream). Please go ahead and report to pdfjam upstream. > > It says that it is any of the many keys of pdfpages, so you need to read > > the documentation of pdfpages, which incidentally can be found with the > > above command. > > Why? $USER installs a basic tool and wants to Because the author of pdfjam has decided so. If you don't like it, why don't you stop complaining and simply use a different tool? I already sugested one, pdftk. Best Norbert -- PREINING Norbert https://www.preining.info Accelia Inc. + IFMGA ProGuide + TU Wien + JAIST + TeX Live + Debian Dev GPG: 0x860CDC13 fp: F7D8 A928 26E3 16A1 9FA0 ACF0 6CAC A448 860C DC13