Re: [Emc-developers] old lyx docs in 2.5

On Wed, 2011-11-02 at 06:56 -0500, John Thornton wrote: > Kirk, > > After reading KimK's document directive in another email on this topic > you should coordinate with him for the 2.5 docs. > > John Oops, I forgot about this. I got a bee in my bonnet when I was looking at some HTML man pages, a

Re: [Emc-developers] old lyx docs in 2.5

Kirk, After reading KimK's document directive in another email on this topic you should coordinate with him for the 2.5 docs. John On 10/26/2011 10:13 AM, Kirk Wallace wrote: > On Wed, 2011-10-26 at 10:08 -0500, John Thornton wrote: >> Kirk, >> >> It depends on how the man page is created. Some

Re: [Emc-developers] old lyx docs in 2.5

>> >> Steve >> >> -Original Message- >> From: John Thornton [mailto:bjt...@gmail.com] >> Sent: Thursday, October 27, 2011 3:06 PM >> To: EMC developers >> Subject: Re: [Emc-developers] old lyx docs in 2.5 >> >> My feelings abo

Re: [Emc-developers] old lyx docs in 2.5

inal Message- > From: John Thornton [mailto:bjt...@gmail.com] > Sent: Thursday, October 27, 2011 3:06 PM > To: EMC developers > Subject: Re: [Emc-developers] old lyx docs in 2.5 > > My feelings about the docs at this point is the only way to have your > cake and eat

Re: [Emc-developers] old lyx docs in 2.5

rsday, October 27, 2011 3:06 PM > To: EMC developers > Subject: Re: [Emc-developers] old lyx docs in 2.5 > > My feelings about the docs at this point is the only way to have your > cake and eat it too is to have the PDF docs be like the HTML and have > just one "EMC Documents".

Re: [Emc-developers] old lyx docs in 2.5

PM To: EMC developers Subject: Re: [Emc-developers] old lyx docs in 2.5 My feelings about the docs at this point is the only way to have your cake and eat it too is to have the PDF docs be like the HTML and have just one "EMC Documents". This does several things, every thing is in one docume

Re: [Emc-developers] old lyx docs in 2.5

On 10/27/2011 10:35 PM, Jon Elson wrote: > I made the last changes to the Pico driver file > docs/src/drivers/pico_ppmc.txt > on 9/9, and made a series of changes before that. This was done both > in master and > the 2.5 branch. But, I believe that NONE of the files in > docs/src/drivers is b

Re: [Emc-developers] old lyx docs in 2.5

Sebastian Kuzminsky wrote: > Well Jon, patches are always welcome. > > The dates on the docs are put there by the build system, I think they > come from the mtime of the VERSION file. That file also provides the > version number. I think the automation that puts docs on the > linuxcnc.org

Re: [Emc-developers] old lyx docs in 2.5

On 10/27/2011 07:26 PM, Jon Elson wrote: > Sebastian Kuzminsky wrote: >> Jon is right, the docs on linuxcnc.org do still have broken math formulas. >> For examples: >> > Yes, and it affects probably 20+ major documents. > > But, the other problem is that the pdf's that are linked on the main > do

Re: [Emc-developers] old lyx docs in 2.5

Sebastian Kuzminsky wrote: > Jon is right, the docs on linuxcnc.org do still have broken math formulas. > For examples: > Yes, and it affects probably 20+ major documents. But, the other problem is that the pdf's that are linked on the main documentation page for the 2.5 and master branches a

Re: [Emc-developers] old lyx docs in 2.5

On 10/27/2011 4:06 PM, John Thornton wrote: > A large number of installs don't have an internet connection and only > have the PDF docs to rely on. > > John > > On 10/27/2011 9:22 AM, Dave wrote: >> John, >> >> Just curious but ..why are there two sets of manuals? (PDF and HTML) >> >> It seems

Re: [Emc-developers] old lyx docs in 2.5

A large number of installs don't have an internet connection and only have the PDF docs to rely on. John On 10/27/2011 9:22 AM, 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. > > D

Re: [Emc-developers] old lyx docs in 2.5

My feelings about the docs at this point is the only way to have your cake and eat it too is to have the PDF docs be like the HTML and have just one "EMC Documents". This does several things, every thing is in one document and is searchable and linkable. You never forget which document had what

Re: [Emc-developers] old lyx docs in 2.5

On 27 October 2011 18:09, Dave wrote: > I generally prefer PDF's since I can download them and put them on a > stick drive. The html docs are great for linking folk with queries (IRC, mailing list, forum) to particular sections and information. I certainly see an argument for having both styles.

Re: [Emc-developers] old lyx docs in 2.5

I didn't realize they came from the same source. I generally prefer PDF's since I can download them and put them on a stick drive. Sometimes internet access is not available. With a big hose to the internet, and cheap high capacity stick drives, downloading and saving large files is not much of

Re: [Emc-developers] old lyx docs in 2.5

Jon is right, the docs on linuxcnc.org do still have broken math formulas. For examples: Look at the bottom of section 6: Maybe missing build dependencies on the machine that auto-builds the docs? Al

Re: [Emc-developers] old lyx docs in 2.5

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. > The HTML can be browsed remotely, quickly, and without downloading the whole document. The PDF's look better, and you can scroll u

Re: [Emc-developers] old lyx docs in 2.5

John Thornton wrote: > My original driving > force to work on the manuals was because I never could remember what > manual I had read something in. Yes, I agree with you there, the info you want at hand while configuring things are spread across maybe THREE different manuals. > I have been wor

Re: [Emc-developers] old lyx docs in 2.5

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. > Yes, it IS there in the HTML, but that is in bad shap

Re: [Emc-developers] old lyx docs in 2.5

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, > > Ju

Re: [Emc-developers] old lyx docs in 2.5

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 re

Re: [Emc-developers] old lyx docs in 2.5

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 monitor

Re: [Emc-developers] old lyx docs in 2.5

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, rathe

Re: [Emc-developers] old lyx docs in 2.5

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. >

Re: [Emc-developers] old lyx docs in 2.5

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

Re: [Emc-developers] old lyx docs in 2.5

I tried to clarify it a bit: http://wiki.linuxcnc.org/emcinfo.pl?Git#Create_an_initial_check_out On Oct 26, 2011, at 15:55 , Kirk Wallace wrote: > On Wed, 2011-10-26 at 15:41 -0600, Sebastian Kuzminsky wrote: >> Looking closer at that wiki page, it does say to cd into that directory, >> sort o

Re: [Emc-developers] old lyx docs in 2.5

On Wed, 2011-10-26 at 15:41 -0600, Sebastian Kuzminsky wrote: > Looking closer at that wiki page, it does say to cd into that directory, sort > of. At the end of step 2 "Create an initial check-out": > > All the commands below assume that you are in the emc2-dev directory unless > noted otherwi

Re: [Emc-developers] old lyx docs in 2.5

Looking closer at that wiki page, it does say to cd into that directory, sort of. At the end of step 2 "Create an initial check-out": All the commands below assume that you are in the emc2-dev directory unless noted otherwise. ;-) On Oct 26, 2011, at 15:29 , Sebastian Kuzminsky wrote: > You

Re: [Emc-developers] old lyx docs in 2.5

On Wed, 2011-10-26 at 15:29 -0600, Sebastian Kuzminsky wrote: > You found a bug or an omission in that web page. The "clone" creates > a local repository in emc2-dev, and you need to cd into it ("cd > emc2-dev") before you can access the repo. ... snip Thank you, you saved me a bunch of time tryi

Re: [Emc-developers] old lyx docs in 2.5

You found a bug or an omission in that web page. The "clone" creates a local repository in emc2-dev, and you need to cd into it ("cd emc2-dev") before you can access the repo. On Oct 26, 2011, at 15:19 , Kirk Wallace wrote: > On Wed, 2011-10-26 at 10:29 -0500, Chris Radek wrote: >> On Wed, Oc

Re: [Emc-developers] old lyx docs in 2.5

On Wed, 2011-10-26 at 10:29 -0500, Chris Radek wrote: > On Wed, Oct 26, 2011 at 08:13:42AM -0700, Kirk Wallace wrote: > > > > So, I take it that if I copy a page and edit it, I can send it to you > > and you will place in an appropriate place? If so, that would be good > > for me. > > Sending a w

Re: [Emc-developers] old lyx docs in 2.5

John Thornton wrote: > There is a link on the documents page to the 2.5 html docs which seem to > be getting built as changes are made. > > http://www.linuxcnc.org/docview/2.5/html/ > > And, it apparently is NOT working, or did not get updated. If you look at the HAL manual / Pico PPMC Driver /

Re: [Emc-developers] old lyx docs in 2.5

On 26 October 2011 16:12, John Thornton wrote: > I think I understand now, a master index page just has links to sub > pages kinda like this > > Getting Started with EMC > EMC User Information > Machine Builder/Integrator Information > HAL User Space Components > HAL Real Time Components > HAL API

Re: [Emc-developers] old lyx docs in 2.5

Yes, that is the preferred way to submit corrections. John On 10/26/2011 10:29 AM, Chris Radek wrote: > On Wed, Oct 26, 2011 at 08:13:42AM -0700, Kirk Wallace wrote: >> So, I take it that if I copy a page and edit it, I can send it to you >> and you will place in an appropriate place? If so, that

Re: [Emc-developers] old lyx docs in 2.5

On Wed, Oct 26, 2011 at 08:13:42AM -0700, Kirk Wallace wrote: > > So, I take it that if I copy a page and edit it, I can send it to you > and you will place in an appropriate place? If so, that would be good > for me. Sending a whole file breaks down as soon as two people are doing it, and someti

Re: [Emc-developers] old lyx docs in 2.5

yep, I can do that... just make sure it is correct :) John On 10/26/2011 10:13 AM, Kirk Wallace wrote: > On Wed, 2011-10-26 at 10:08 -0500, John Thornton wrote: >> Kirk, >> >> It depends on how the man page is created. Some are hand written man >> pages and some are generated from the component

Re: [Emc-developers] old lyx docs in 2.5

On Wed, 2011-10-26 at 10:08 -0500, John Thornton wrote: > Kirk, > > It depends on how the man page is created. Some are hand written man > pages and some are generated from the component file. All need to be > done through a developer with git push rights like me for instance. > > John So, I

Re: [Emc-developers] old lyx docs in 2.5

I think I understand now, a master index page just has links to sub pages kinda like this Getting Started with EMC EMC User Information Machine Builder/Integrator Information HAL User Space Components HAL Real Time Components HAL API Calls ... and each one brings up a page with the correct subje

Re: [Emc-developers] old lyx docs in 2.5

Kirk, It depends on how the man page is created. Some are hand written man pages and some are generated from the component file. All need to be done through a developer with git push rights like me for instance. John On 10/26/2011 9:36 AM, Kirk Wallace wrote: > On Wed, 2011-10-26 at 07:30 -05

Re: [Emc-developers] old lyx docs in 2.5

On Wed, 2011-10-26 at 07:30 -0500, John Thornton wrote: > You can do that now with all the userspace, realtime, api and the other one. > > http://gnipsel.com/emc2/html2.5/man/man9/deadzone.9.html > > John In looking at this example, it reminded me to ask, what is the best way for someone fill in

Re: [Emc-developers] old lyx docs in 2.5

You can do that now with all the userspace, realtime, api and the other one. http://gnipsel.com/emc2/html2.5/man/man9/deadzone.9.html John On 10/26/2011 7:16 AM, andy pugh wrote: > I mean, I think that there should be a "Hal Realtime Components" link > that takes you to a page with links to each

Re: [Emc-developers] old lyx docs in 2.5

I mean, I think that there should be a "Hal Realtime Components" link that takes you to a page with links to each realtime component, rather than linking them all directly from the main index. Similary for the userspace hal components and the APIs. This is partly because I would like to be able to

Re: [Emc-developers] old lyx docs in 2.5

Also I see that Halmeter, Stepgen and the others that are in the Realtime Components section need to be broken up so seperate entries for them can exist in the HTML docs. John On 10/26/2011 6:38 AM, andy pugh wrote: > On 26 October 2011 12:19, John Thornton wrote: > >> http://gnipsel.com/emc2/

Re: [Emc-developers] old lyx docs in 2.5

Actually in the Hal Manual section the Hal Components is redundant and was only created for the PDF docs as the man pages for all of them are just an inch or so down on the page and needs to be removed. John On 10/26/2011 6:38 AM, andy pugh wrote: > On 26 October 2011 12:19, John Thornton wrot

Re: [Emc-developers] old lyx docs in 2.5

I don't understand what you mean, can you expand a bit on it for me? John On 10/26/2011 6:38 AM, andy pugh wrote: > On 26 October 2011 12:19, John Thornton wrote: > >> http://gnipsel.com/emc2/html2.5/index.html > I think it has been said before, but it probably makes sense to move > the HAL comp

Re: [Emc-developers] old lyx docs in 2.5

On 26 October 2011 12:19, John Thornton wrote: > http://gnipsel.com/emc2/html2.5/index.html I think it has been said before, but it probably makes sense to move the HAL components and API calls to a sub-index. -- atp "Torque wrenches are for the obedience of fools and the guidance of wise men

Re: [Emc-developers] old lyx docs in 2.5

I can remove the lyx files from 2.5 if your busy with other things. Just give me the word. John Thornton On 10/26/2011 1:31 AM, Sebastian Kuzminsky wrote: > On 10/26/2011 12:07 AM, Pavel Shramov wrote: >> On Tue, Oct 25, 2011 at 04:39:23PM -0600, Sebastian Kuzminsky wrote: >>> Yeah, I was hopin

Re: [Emc-developers] old lyx docs in 2.5

There is a link on the documents page to the 2.5 html docs which seem to be getting built as changes are made. http://www.linuxcnc.org/docview/2.5/html/ I think the organization of the 2.5 HTML's is quite confusing and the overleaf and other pages repeated over and over make no sense and only

Re: [Emc-developers] old lyx docs in 2.5

I kinda wondered why the lyx stuff was still in 2.5... I have no need for them. John Thornton On 10/25/2011 8:56 AM, Sebastian Kuzminsky wrote: > Hi folks, Michael Haberler pointed out that it's a bit confusing to have > the .lyx doc source files in 2.5, since they are not used there any > more.

Re: [Emc-developers] old lyx docs in 2.5

On 10/26/2011 12:07 AM, Pavel Shramov wrote: > On Tue, Oct 25, 2011 at 04:39:23PM -0600, Sebastian Kuzminsky wrote: >> Yeah, I was hoping to get feedback from the docs folks. I don't want to >> remove the lyx source files if they're still using them, and i don't want to >> leave the lyx files arou

Re: [Emc-developers] old lyx docs in 2.5

On Tue, Oct 25, 2011 at 04:39:23PM -0600, Sebastian Kuzminsky wrote: > Yeah, I was hoping to get feedback from the docs folks. I don't want to > remove the lyx source files if they're still using them, and i don't want to > leave the lyx files around if they're finished with them. Since it's alway

Re: [Emc-developers] old lyx docs in 2.5

> It'd be easiest if i could have a passphrase-less ssh key that could rsync > the docs to the proper place on linuxcnc.org. Alternatively, we could run > a buildslave on linuxcnc.org and build the docs there, but that seems like > more of a hassle. > > Who admins linuxcnc.org? Any thoughts on

Re: [Emc-developers] old lyx docs in 2.5

On Oct 25, 2011, at 15:53 , Kent A. Reed wrote: > Works for me. I was being conservative because of the "we've (mostly?) > transitioned" comment in your first message. Yeah, I was hoping to get feedback from the docs folks. I don't want to remove the lyx source files if they're still using th

Re: [Emc-developers] old lyx docs in 2.5

On Oct 25, 2011, at 15:40 , Kent A. Reed wrote: > On 10/25/2011 9:56 AM, Sebastian Kuzminsky wrote: >> Hi folks, Michael Haberler pointed out that it's a bit confusing to have >> the .lyx doc source files in 2.5, since they are not used there any >> more. We've (mostly?) transitioned to asciidoc,

Re: [Emc-developers] old lyx docs in 2.5

On 10/25/2011 9:56 AM, Sebastian Kuzminsky wrote: > Hi folks, Michael Haberler pointed out that it's a bit confusing to have > the .lyx doc source files in 2.5, since they are not used there any > more. We've (mostly?) transitioned to asciidoc, which has the matching > .txt files as their source.

Re: [Emc-developers] old lyx docs in 2.5

The new html docs in 2.5 do build fine, but they're not getting auto-built and published anywhere. I want to have the buildbot produce html and pdf docs, and I want to upload them to someplace with better outgoing bandwidth than my garage… It'd be easiest if i could have a passphrase-less ssh k

Re: [Emc-developers] old lyx docs in 2.5

Sebastian Kuzminsky wrote: > Hi folks, Michael Haberler pointed out that it's a bit confusing to have > the .lyx doc source files in 2.5, since they are not used there any > more. We've (mostly?) transitioned to asciidoc, which has the matching > .txt files as their source. > > Is it time to re

[Emc-developers] old lyx docs in 2.5

Hi folks, Michael Haberler pointed out that it's a bit confusing to have the .lyx doc source files in 2.5, since they are not used there any more. We've (mostly?) transitioned to asciidoc, which has the matching .txt files as their source. Is it time to remove the old .lyx files from 2.5? I d