GithubHelp home page GithubHelp logo

Can't convert xml to man about roxterm HOT 3 CLOSED

realh avatar realh commented on September 6, 2024
Can't convert xml to man

from roxterm.

Comments (3)

realh avatar realh commented on September 6, 2024

I've fixed this in svn and also added more locations for the automatic search. Unfortunately I haven't been able to include the paths above, because the version number in the pathname complicates things somewhat. Does Fedora ever have more than one version installed at once?

Original comment by: realh

from roxterm.

realh avatar realh commented on September 6, 2024

Why are you not included generated man page in the destitution? Troff is enough portable format to redistribute it. Also your way to transform Docbook XML to man page is not portable because its depends on absolute file location of XSL stylesheet. Its more portable to use standard external URL, and then use XML Catalog feature to map external entities to local files. Also there is nice tool called xmlto that do all this work, you simply type "xmlto man roxterm.xml" and your man page is ready. Think about it. Thanks.

Original comment by: lostclus

from roxterm.

realh avatar realh commented on September 6, 2024

Why are you not included generated man page in the destitution? Troff is
enough portable format to redistribute it.

They have to be generated at build time because they contain references
to pathnames which depend on the installation prefix. I could do the
substitution in the nroff files instead, but I want to keep
straightforward rules for generating them from XML, and doing the
substitution after the generation would be the wrong order for
configure-make.

Also your way to transform
Docbook XML to man page is not portable because its depends on absolute
file location of XSL stylesheet. Its more portable to use standard external
URL, and then use XML Catalog feature to map external entities to local
files. Also there is nice tool called xmlto that do all this work, you
simply type "xmlto man roxterm.xml" and your man page is ready. Think about
it. Thanks.

Agreed, I'm switching to xmlto. I originally wrote the man pages for
Debian, whose templates suggests using xsltproc, which is OK for Debian
because you can ensure the XSL file is installed and know where, and
avoid an extra dependency on xmlto. But xmlto is clearly easier for
upstream.

Original comment by: realh

from roxterm.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.