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
