On Saturday 21 November 2020 22:48:11 Chris Morley wrote: > They _were_ removed already - because they broke the packaging. > I already mentioned that. > > The whole point of this email is to figure out what to do to get the > wanted behavior. You seem to be a bit aggressive against it and I > don't understand why. Other people have asked for HTML docs - we even > build them. > Seems we just don't distribute them. > > I am just building a deb package from sources and I can see that only > PDF docs are built. I'll see what happens if i change that to HTML ... > > Chris
As one whose had to jump thru a few hoops to get all the Sphinx dependencies on armhf, I must say that it even shows in the improved gfx in the .pdf's. A tip of the hat to all involved. However if the bible on LCNC is to be converted to html, I'd say dropping the pdf's as an immediate goal would be undesirable. A pdf reader/printer driver such as evince, is a lot less resource hungry than firefox has become. My $0.02 in 1934 dollars. > ________________________________ > From: Rod Webster <r...@vmn.com.au> > Sent: November 22, 2020 3:30 AM > To: EMC developers <emc-developers@lists.sourceforge.net> > Subject: Re: [Emc-developers] Offline Sphinx HTML docs in project > > Really, the non compliant HTML docs should be removed and bought in > line with the Linuxcnc authoring environment regardless of how > obsolete our standards are. There is no place for making exceptions to > suit one author. The standard should only change if its applied across > the board. > > Rod Webster > *1300 896 832* > +61 435 765 611 > VMN® > www.vmn.com.au<http://www.vmn.com.au> > > > > On Sun, 22 Nov 2020 at 13:14, Chris Morley > <chrisinnana...@hotmail.com> > > wrote: > > On 2020-11-21 5:59 p.m., Rod Webster wrote: > > > Can't programs (like qtdragon) reliably reference the official > > > published docs for the version of Linuxcnc they were deployed > > > with? > > > > I don't think so. They of course they can reference them on the net > > - but that's not helpful if you are offline. > > > > I'll have to install linuxcnc on a system and see if the compiled > > HTML docs are on it. > > > > > Surely that solves the problem and ensures the docs are always up > > > to > > > > date. > > > > > There is no way I want to depend on offline docs when the living > > > up to > > > > date > > > > > current docs exist. > > > > The 'offline' docs would be as up to date as the linuxcnc package > > is. In QtDragon's case they were actually very similar to our docs > > and I would prefer they be the same source. So maybe I'm asking how > > to create Sphinx HTML docs from our sources that can be included as > > installed files. > > > > Some of this is a similar problem that translations have- the > > process of making of docs/translations for a certain part (say > > qtdragon) is too big/difficult for the average person. I'd also say > > the docs are looking a bit dated these days - I must say the sphinx > > docs look very sharp. > > > > > > Chris > > > > > > > > > > _______________________________________________ > > Emc-developers mailing list > > Emc-developers@lists.sourceforge.net > > https://lists.sourceforge.net/lists/listinfo/emc-developers > > _______________________________________________ > Emc-developers mailing list > Emc-developers@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/emc-developers > > _______________________________________________ > Emc-developers mailing list > Emc-developers@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/emc-developers Cheers, Gene Heskett -- "There are four boxes to be used in defense of liberty: soap, ballot, jury, and ammo. Please use in that order." -Ed Howdershelt (Author) If we desire respect for the law, we must first make the law respectable. - Louis D. Brandeis Genes Web page <http://geneslinuxbox.net:6309/gene> _______________________________________________ Emc-developers mailing list Emc-developers@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/emc-developers
