There are two output formats (html and pdf), but there is only one source. So it's no hassle, except when one of the output formats is broken and needs to be fixed (like the equations in html thing), but luckily we have psha for that ;-)
On Oct 27, 2011, at 08:22 , Dave wrote: > John, > > Just curious.... but ..why are there two sets of manuals? (PDF and HTML) > > It seems like it would be a lot easier to maintain just one. > > Dave > > On 10/27/2011 7:19 AM, John Thornton wrote: >> Was there a general consensus among the developers that anything with >> the word HAL in it should be removed from the Integrators Manual? I for >> one am against it for one reason, it leaves the integrator manual >> lacking vital information to build and set up a machine. Even with large >> screen monitors having to have two pdf's open along with your configs >> and jumping back and forth makes no sense to me. My original driving >> force to work on the manuals was because I never could remember what >> manual I had read something in. I have been working for years trying to >> reduce the HAL manual to only those things that pertain to running HAL >> standalone and making the Integrator Manual the place for all the >> information a machine integrator might need, but I guess that has been >> all been changed... >> >> We do have two sets of documents the pdf and the html and I know of no >> reason they must match exactly in layout. They are two completely >> different ways of having the information with different navigation schemes. >> >> John >> >> On 10/27/2011 3:21 AM, Kim Kirwan wrote: >> >>> Two quick comments: >>> >>> (1) There shouldn't be anything missing that I am aware of. >>> The various drivers, along with many other HAL-related items, >>> have been moved to the HAL manual. The drivers should be in >>> Part II. >>> >>> (2) If another layout is desired for the HTML docs, it should >>> be in addition to, rather than instead of, the current layout. >>> This is because one of my goals was to get our HTML docs layout >>> to match our PDF docs, so we didn't appear to have two sets >>> of docs. I have no objection to having a second HTML layout if >>> it is more familiar or convenient. >>> >>> Kim >>> >>> >>> On 10/26/2011 11:22 PM, Jon Elson wrote: >>> >>>> John Thornton wrote: >>>> >>>>> I pushed on the 24th to the 2.5 docs and it showed up within an hour or >>>>> two. >>>>> >>>>> Everything except 2.4 docs are merge up from the branch. For 2.4 docs >>>>> you must push to the 2.4 branch the .lyx change and for 2.5 docs you >>>>> must push the .txt change to the 2.5 branch. >>>>> >>>>> I'm unsure about the state of the latexmath but I though I saw a fix for >>>>> that somewhere. I can look into why so much is missing from the PDF's >>>>> this weekend. >>>>> >>>>> >>>> If you want a real horror show, see the kinematics section of the >>>> integrators manual. >>>> The pdf has a bunch of formulas in it, the 2.5 html version is just a mess. >>>> >>>> Kim Kirwan was going to look at the omissions, and I think maybe it was >>>> Pavel >>>> that said he did something that fixed the latexmath conversion. I hope >>>> I didn't >>>> dream it, I am pretty sure somebody said they had committed a fix that made >>>> the latexmath work, but I must not have saved the message. >>>> >>>> Jon >>>> >>>> ------------------------------------------------------------------------------ >>>> The demand for IT networking professionals continues to grow, and the >>>> demand for specialized networking skills is growing even more rapidly. >>>> Take a complimentary Learning@Cisco Self-Assessment and learn >>>> about Cisco certifications, training, and career opportunities. >>>> http://p.sf.net/sfu/cisco-dev2dev >>>> _______________________________________________ >>>> Emc-developers mailing list >>>> [email protected] >>>> https://lists.sourceforge.net/lists/listinfo/emc-developers >>>> >>>> >>>> >>> ------------------------------------------------------------------------------ >>> The demand for IT networking professionals continues to grow, and the >>> demand for specialized networking skills is growing even more rapidly. >>> Take a complimentary Learning@Cisco Self-Assessment and learn >>> about Cisco certifications, training, and career opportunities. >>> http://p.sf.net/sfu/cisco-dev2dev >>> _______________________________________________ >>> Emc-developers mailing list >>> [email protected] >>> https://lists.sourceforge.net/lists/listinfo/emc-developers >>> >> ------------------------------------------------------------------------------ >> The demand for IT networking professionals continues to grow, and the >> demand for specialized networking skills is growing even more rapidly. >> Take a complimentary Learning@Cisco Self-Assessment and learn >> about Cisco certifications, training, and career opportunities. >> http://p.sf.net/sfu/cisco-dev2dev >> _______________________________________________ >> Emc-developers mailing list >> [email protected] >> https://lists.sourceforge.net/lists/listinfo/emc-developers >> >> > > > ------------------------------------------------------------------------------ > The demand for IT networking professionals continues to grow, and the > demand for specialized networking skills is growing even more rapidly. > Take a complimentary Learning@Cisco Self-Assessment and learn > about Cisco certifications, training, and career opportunities. > http://p.sf.net/sfu/cisco-dev2dev > _______________________________________________ > Emc-developers mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/emc-developers -- Sebastian Kuzminsky ------------------------------------------------------------------------------ The demand for IT networking professionals continues to grow, and the demand for specialized networking skills is growing even more rapidly. Take a complimentary Learning@Cisco Self-Assessment and learn about Cisco certifications, training, and career opportunities. http://p.sf.net/sfu/cisco-dev2dev _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
