Omnimaga

Calculator Community => Major Community Projects => The Axe Parser Project => Topic started by: yoman82 on June 03, 2010, 05:06:26 pm

Title: On Calc Documentation
Post by: yoman82 on June 03, 2010, 05:06:26 pm
Would it be possible to convert the command list and the documentation into an independent app, include them in the Axe app or make a DocDE file of them? It'd be really helpful, since memorizing these commands is difficult...
I did it with the command list, however .pdf to .txt conversion is rather difficult.
Title: Re: On Calc Documentation
Post by: DJ Omnimaga on June 03, 2010, 05:32:21 pm
I think he is planning for future Axe versions to have a small summary of command syntax included with the app. However it will most likely be small or short, to not make the app too large.
Title: Re: On Calc Documentation
Post by: Deep Toaster on June 03, 2010, 08:12:26 pm
I think he is planning for future Axe versions to have a small summary of command syntax included with the app. However it will most likely be small or short, to not make the app too large.

That'd be nice. I'm still carrying around a printed copy of the documentation everywhere my calculator goes (which is to say everywhere :)).
Title: Re: On Calc Documentation
Post by: calcdude84se on June 03, 2010, 09:21:22 pm
That "Help" item in the app menu has been annoying me... I hope he either gets rid of it or makes it do something...
Deep Thought: Geeks FTW :)
Title: Re: On Calc Documentation
Post by: ztrumpet on June 03, 2010, 10:14:38 pm
I hope eventually he'll make a Catalog Help style App for Axe.  I think that would be extremely useful. :D
Title: Re: On Calc Documentation
Post by: DJ Omnimaga on June 03, 2010, 10:17:03 pm
Deep Thought: Geeks FTW :)
^

Also ctlghelp app would be nice. Just make sure to maybe include it as an option if it's gonna be more than 2 pages of APP, though.
Title: Re: On Calc Documentation
Post by: Quigibo on June 03, 2010, 11:03:34 pm
There will eventually be some on-calculator help.  That's why the help button is there.  It will take a lot of time to write though, which is why I'm not going to add it until the end.
Title: Re: On Calc Documentation
Post by: jsj795 on June 03, 2010, 11:33:16 pm
There will eventually be some on-calculator help.  That's why the help button is there.  It will take a lot of time to write though, which is why I'm not going to add it until the end.
Yeah I suggest adding it in the end, because the parsing is the priority, right ;)
Or can't someone make another app for people who want it on their calc, and people who mastered Axe can delete it for more room?
Title: Re: On Calc Documentation
Post by: DJ Omnimaga on June 03, 2010, 11:42:57 pm
Plus if he adds it now, he'll need to update it every version (and may even forget sometimes, like how he just forgot to change 0.2.5 to 0.2.6 at the top of the doc pages ;D) which will slow down updates x.x.

I like jsj suggestion about separate APP, though.
Title: Re: On Calc Documentation
Post by: yoman82 on June 04, 2010, 02:56:53 pm
I could give y'all my copy of the command list converted to Ebook format readable on the 83, if you want.
Title: Re: On Calc Documentation
Post by: yunhua98 on June 04, 2010, 05:06:27 pm
  /\
  || Yes, I want it!  (Yay!  Don't have to comment the thing I want my program to do every time I don't have the command list!)
  could you attach it here instead of emailing it though?
Title: Re: On Calc Documentation
Post by: DJ Omnimaga on June 04, 2010, 05:14:53 pm
What software do we need to open the Ebook? I assume either DocDE from Cemetech or Notefolio from TI, right?
Title: Re: On Calc Documentation
Post by: _player1537 on June 04, 2010, 06:24:54 pm
there's a ebook convertor on ticalc I've used to make the illiad and sherlock holmes, worked well, just didn't feel like reading them :)  is that what you are using yoman?  (btw it makes it an independant app so you only need the one app to read it)
Title: Re: On Calc Documentation
Post by: calcdude84se on June 04, 2010, 07:33:55 pm
I take it you're talking about Flashbook 1.0 beta 4 (http://sourceforge.net/projects/flashbook/)?
I've use it a few times myself.
Title: Re: On Calc Documentation
Post by: DJ Omnimaga on June 04, 2010, 07:38:07 pm
I did not even know that existed. In fact, for e-books, besides Notefolio/DocDE and K-Edit (discontinued) I was certain they were only available for 68k calculators.

Is that program even on ticalc.org?
Title: Re: On Calc Documentation
Post by: Deep Toaster on June 04, 2010, 07:46:28 pm
http://www.ticalc.org/archives/files/fileinfo/418/41869.html for Unix, http://www.ticalc.org/archives/files/fileinfo/418/41871.html for Mac, http://www.ticalc.org/archives/files/fileinfo/418/41870.html for Windows
Title: Re: On Calc Documentation
Post by: calcdude84se on June 04, 2010, 07:47:52 pm
yeah, just search for flashbook. The SF link is more useful if you ask me, though.
Title: Re: On Calc Documentation
Post by: DJ Omnimaga on June 04, 2010, 07:54:34 pm
aaaah ok. I tend to not look much into those sections of ticalc, which is probably why I didn't notice it.
Title: Re: On Calc Documentation
Post by: yoman82 on June 05, 2010, 04:23:23 pm
Here you go! It's an independent app, made with that tool you guys were talking about. It's for .2.5, but I'd make a .2.6 version if you want.
Title: Re: On Calc Documentation
Post by: Deep Toaster on June 05, 2010, 04:59:59 pm
Here you go! It's an independent app, made with that tool you guys were talking about. It's for .2.5, but I'd make a .2.6 version if you want.

Are there differences between the v0.2.5 and v0.2.6 Axe Documentations (besides the numbers, of course)?
Title: Re: On Calc Documentation
Post by: DJ Omnimaga on June 05, 2010, 05:06:27 pm
The addition of very simple interrupts, a sort command and some changes with pointers.

Keep in mind, Yoman82, that Axe is updated at a rather regular rate, so you would need to update your app over and over, and unnoficial versions (not posted by Quibigo) are not allowed in the contest
Title: Re: On Calc Documentation
Post by: yoman82 on June 05, 2010, 05:20:35 pm
I'm more than willing to update it if people want.
Also, what unofficial versions of AXE? And this isn't related to the contest, I don't think.
Title: Re: On Calc Documentation
Post by: DJ Omnimaga on June 05, 2010, 05:32:21 pm
Oh wait, I thought the Axe app you posted above was a hacked version of Quigibo's app, adding the command index in it. Sorry, my bad. But yeah I added the rule in case people released patched versions of Axe adding new commands or the like  in the future (which I doubt, but we never know) to do stuff you wouldn't be able to do normally with a real Axe app, allowing them to cheat in the contest.
Title: Re: On Calc Documentation
Post by: yunhua98 on June 05, 2010, 08:33:13 pm
For some reason, when I try to send AXED.8xk to my calc, it says I/O request aborted, then my RAM gets cleared.
Title: Re: On Calc Documentation
Post by: willrandship on June 05, 2010, 08:44:25 pm
Well, it works for me. Personally, I think it could be made to look a little better, but it converted suprisingly well as-is. If I were making it from scratch I'd probably make it more like the ctlghelp app. It would be really awesome if it could integrate into the OS like that, too.
Title: Re: On Calc Documentation
Post by: Deep Toaster on June 05, 2010, 08:49:53 pm
Well, it works for me. Personally, I think it could be made to look a little better, but it converted suprisingly well as-is. If I were making it from scratch I'd probably make it more like the ctlghelp app. It would be really awesome if it could integrate into the OS like that, too.

That'd be a nice idea: a hacked version of CtlgHelp (is it copyrighted?) that displays Axe syntax for items such as det( as well as the pure BASIC use.
Title: Re: On Calc Documentation
Post by: willrandship on June 05, 2010, 08:52:14 pm
Does it matter if it's copyrighted? If we just distribute a patch file, we're fine, just like rom hacks, right?
Title: Re: On Calc Documentation
Post by: calcdude84se on June 05, 2010, 08:52:42 pm
well, we could just create our own app, the only problem being that the catalog hooks are not well-documented.
Title: Re: On Calc Documentation
Post by: yoman82 on June 06, 2010, 09:17:21 am
Well, it works for me. Personally, I think it could be made to look a little better, but it converted suprisingly well as-is. If I were making it from scratch I'd probably make it more like the ctlghelp app. It would be really awesome if it could integrate into the OS like that, too.
We could probably get some amazing guy like Brandonw to disassemble it for us and just replace the text.
That'd be a nice idea: a hacked version of CtlgHelp (is it copyrighted?) that displays Axe syntax for items such as det( as well as the pure BASIC use.
Title: Re: On Calc Documentation
Post by: Silver Shadow on June 06, 2010, 09:31:59 am
Ermm... yeah? What is the purpose of just quoting other people?
Title: Re: On Calc Documentation
Post by: Galandros on June 06, 2010, 09:44:44 am
well, we could just create our own app, the only problem being that the catalog hooks are not well-documented.
See if this documentation solves your problem.
http://wikiti.brandonw.net/index.php?title=83Plus:Hooks:Catalog
And you can count on help from BrandonW in the irc.

I wonder if Quiguibo will add this on Axe Parser final releases.
Title: Re: On Calc Documentation
Post by: Deep Toaster on June 06, 2010, 08:37:12 pm
It'd also have a pretty effective on-calc documentation if the help section had a Symbolic-style guide, but just with syntax.
Title: Re: On Calc Documentation
Post by: DJ Omnimaga on June 07, 2010, 04:49:55 am
Keep in mind that adding too many hooks might conflict with certain shells, though. I think KermMartian is planning to keep DCS7 compatible with Axe, but it is still something to think about, especially when using too many.