On 4/5/2018 1:28 AM, Henri Menke wrote:
On Thu, 2018-04-05 at 01:18 +0200, Hans Hagen wrote:
On 4/5/2018 12:43 AM, Henri Menke wrote:

Dear list,

I'm sure you aware of the very useful "texdoc" command line utility in TeX
live
which brings up the PDF documentation for packages.  ConTeXt standalone also
comes with documentation in

      /opt/context/tex/texmf-context/doc/context

However, I find it tedious to always search for the correct subfolder to get
to
the document I need.  It would be great if there was something like

      mtxrun --script doc metafun

which would open the MetaFun manual.  Similarly "mtxrun --script doc
gnuplot"
would open the manual of the gnuplot module, etc.
this is one of these magic features that suddenly is available on your
system

mtxrun --launch metafun*.pdf
mtxrun --launch cld-mkiv.pdf
mtxrun --all --launch "*-mkiv.pdf"

Hm, that requires that I know enough about the name of the document.  A list
would be quite nice in the sense that I could just type "metafun" and then
select from "metafun-p.pdf" and "metafun-s.pdf" instead of opening both
documents.

on my machine opening the lot is fast enough but anyway it's a trivial extension, so i've added --list

>mtxrun --launch --list *-mkiv.pdf
mtxrun | 1: charts-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 2: cld-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 3: colors-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 4: epub-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 5: fonts-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/fonts mtxrun | 6: languages-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 7: libraries-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 8: lua-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 9: mag-0000-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines mtxrun | 10: mag-0002-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines mtxrun | 11: mag-0006-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines mtxrun | 12: mag-0007-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines mtxrun | 13: mag-0010-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines mtxrun | 14: mag-1101-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines mtxrun | 15: mag-1102-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines mtxrun | 16: mag-1103-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/magazines mtxrun | 17: math-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 18: rules-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 19: spacing-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 20: spreadsheets-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 21: sql-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 22: steps-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 23: swiglib-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 24: templates-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 25: tools-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 26: units-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 27: workflows-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 28: xml-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals mtxrun | 29: xtables-mkiv.pdf c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals


[select number]

>> 4

mtxrun | launching: c:/data/develop/tex-context/tex/texmf-context/doc/context/documents/general/manuals/epub-mkiv.pdf


features like that have always been present in the context suite of
programs (i bet even before texdoc) but it might be that i don't call
the right thing on todays linux:

local launchers={
    windows="start %s",
    macosx="open %s",
    unix="$BROWSER %s &> /dev/null &",
}

I'm quite sure it should be xdg-open (or $PDFVIEWER if it is set and the file is
PDF) on Linux.  For me $BROWSER is unset.
https://linux.die.net/man/1/xdg-open

$ mtxrun --launch metafun*.pdf
resolvers       | resolving | forcing filetype 'tex'
resolvers       | resolving | checking wildcard 'metafun*.pdf'
resolvers       | methods | resolving, method 'concatinators', how 'tag', tag
'file'
resolvers       | methods | resolving, method 'concatinators', how 'tag', tag
'file'
mtxrun          | launching /opt/context/tex/texmf-
context/doc/context/documents/general/manuals/metafun-p.pdf
sh: 1: /opt/context/tex/texmf-
context/doc/context/documents/general/manuals/metafun-p.pdf: Permission denied

there's also

mtxrun --edit kpse:cld-mkiv.tex

we can of course extend this feature with some listing but then i'd
rather consult the descriptive files xml but i'm not sure if i
distribute them yet


See attached for my shitty prototype.

Cheers, Henri



____________________________________________________________________________
_______
If your question is of interest to others as well, please add an entry to
the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-conte
xt
webpage  : http://www.pragma-ade.nl / http://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki     : http://contextgarden.net
____________________________________________________________________________
_______


___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki     : http://contextgarden.net
___________________________________________________________________________________



--

-----------------------------------------------------------------
                                          Hans Hagen | PRAGMA ADE
              Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
       tel: 038 477 53 69 | www.pragma-ade.nl | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://context.aanhet.net
archive  : https://bitbucket.org/phg/context-mirror/commits/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Reply via email to