Author Topic: The Axe Pages  (Read 28667 times)

0 Members and 1 Guest are viewing this topic.

Offline Quigibo

  • The Executioner
  • CoT Emeritus
  • LV11 Super Veteran (Next: 3000)
  • *
  • Posts: 2031
  • Rating: +1075/-24
  • I wish real life had a "Save" and "Load" button...
    • View Profile
The Axe Pages
« on: April 10, 2010, 03:08:20 am »
The time has come!  Yes, I need to actually start making a manual and/or tutorial for how to use Axe Parser.  I need at least a small one so I can release the beta next week or else new coders will have no clue how it works and this subforum is getting way too large to find that type of information.  I'd like to have a very clean format.  HTML is okay, but I'd really prefer a pdf instead so I can have more control with the formatting and it just looks nicer in general.  So does anyone know a good free program that can do the job?  Or if someone is really good with this kind of stuff and would be willing to put the articles together, that would be great too.

Which brings me to my next point.  I think I'll need a lot of help writing this since there's already over 100 commands and I'd like to eventually have a little paragraph about each one with an example or two.  If you're already experienced with the language and you have a little time to volunteer, let me know so I can put this together this week.  Even if you aren't an Axe expert, you can still help with formatting, reviewing, and writing the general stuff.  And yes, everyone that helps gets credited.

I'm not actually going to start writing this until after the next update which should be tomorrow, but I just want to see who can help.  I'll get everyone's email via PM and partition the load depending on the situation.

This community has already helped with the project enormously with all your feedback and motivation for me to continue at this pace.  Thanks so much!  ;D
« Last Edit: April 10, 2010, 03:09:18 am by Quigibo »
___Axe_Parser___
Today the calculator, tomorrow the world!

Offline DJ Omnimaga

  • Clacualters are teh gr33t
  • CoT Emeritus
  • LV15 Omnimagician (Next: --)
  • *
  • Posts: 55941
  • Rating: +3154/-232
  • CodeWalrus founder & retired Omnimaga founder
    • View Profile
    • Dream of Omnimaga Music
Re: The Axe Pages
« Reply #1 on: April 10, 2010, 03:21:06 am »
I think Open Office or Abiword had tools to create PDFs, but I personally am unsure if they are reliable. I know TsukasaZX was working on a PDF based newsletter a while ago (I wonder what happened to it x.x) so maybe he could do it.

It would be nice to have each commands (or at least, the complex ones) be documented more, too. What I think, however, is that the old doc should be kept too. TL;DR people might be scared at the large one so they might like a small format doc too. Examples might be cool too. I don't think it really needs a very complex formatting, though. A PDF can get pretty large if it contains too many images.

I also agree that this sub-forum grew pretty fast. I think eventually it will almost require its own entire set of subforums o.o.

And glad we could help :)

Offline meishe91

  • Super Ninja
  • LV11 Super Veteran (Next: 3000)
  • ***********
  • Posts: 2946
  • Rating: +115/-11
    • View Profile
    • DeviantArt
Re: The Axe Pages
« Reply #2 on: April 10, 2010, 03:43:56 am »
I can basically do any part of helping with this, and would really like to. The only things I can't really help with is creating example codes and explanations for the codes and I wouldn't be able to do things relating to the code. But I can proofread, expand, edit, etc. everything others write and I can organize everything. I can also most likely put it into a PDF file. If I start working with Axe soon and get the hang of it and what the commands are I can then start helping with the things I said I couldn't. But would love to help anyway I can :)
Spoiler For Spoiler:



For the 51st time, that is not my card! (Magic Joke)

Offline Silver Shadow

  • Beta Tester
  • LV8 Addict (Next: 1000)
  • ********
  • Posts: 817
  • Rating: +27/-7
    • View Profile
Re: The Axe Pages
« Reply #3 on: April 10, 2010, 04:21:45 am »
I recommend using OpenOffice for PDFs. I can't help with anything at the moment though, I have to finish my CD beta before the end of Easter Holidays, and I still have lots of things to add to it.
« Last Edit: April 10, 2010, 04:25:20 am by Silver Shadow »
Former Coder of Tomorrow


Offline Raylin

  • Godslayer
  • LV10 31337 u53r (Next: 2000)
  • **********
  • Posts: 1392
  • Rating: +83/-25
  • I am a certifiable squirrel ninja.
    • View Profile
    • Ray M. Perry
Re: The Axe Pages
« Reply #4 on: April 10, 2010, 09:50:28 am »
I'm up for it.
Just tell me what to do.
:)
Bug me about my book.

Sarah: TI-83 Plus Silver Edition [OS 1.19]
Cassie: TI-86 [OS 1.XX]
Elizabeth: TI-81 [OS 1.XX]
Jehuty: TI-83 Plus Silver Edition [OS 1.19]
Tesla: CASIO Prizm







SirCmpwn

  • Guest
Re: The Axe Pages
« Reply #5 on: April 10, 2010, 10:10:05 am »
I use Word for PDFs, but it's not free.  If you guys want to create your stuff in various formats (doc, docx, odt, ect), then I can put them all together into a PDF.
Also, I feel compeltely comfortable with Axe if you want me to help write some stuff.

_player1537

  • Guest
Re: The Axe Pages
« Reply #6 on: April 10, 2010, 01:48:26 pm »
I would love to help, I understand the syntax pretty well so I could do documentation on them.

Offline mapar007

  • LV7 Elite (Next: 700)
  • *******
  • Posts: 550
  • Rating: +28/-5
  • The Great Mata Mata
    • View Profile
Re: The Axe Pages
« Reply #7 on: April 10, 2010, 01:49:27 pm »
I think Open Office or Abiword had tools to create PDFs, but I personally am unsure if they are reliable. I know TsukasaZX was working on a PDF based newsletter a while ago (I wonder what happened to it x.x) so maybe he could do it.


OpenOffice PDF generator has worked for me in the past, even with weird math formulas in them :P

Offline Builderboy

  • Physics Guru
  • CoT Emeritus
  • LV13 Extreme Addict (Next: 9001)
  • *
  • Posts: 5673
  • Rating: +613/-9
  • Would you kindly?
    • View Profile
Re: The Axe Pages
« Reply #8 on: April 10, 2010, 01:52:31 pm »
Mmmmm i don't know if i am familiar with Axe syntax enough to be of any help... X.X



;)

SirCmpwn

  • Guest
Re: The Axe Pages
« Reply #9 on: April 10, 2010, 01:53:27 pm »
lol ;D

Offline DJ Omnimaga

  • Clacualters are teh gr33t
  • CoT Emeritus
  • LV15 Omnimagician (Next: --)
  • *
  • Posts: 55941
  • Rating: +3154/-232
  • CodeWalrus founder & retired Omnimaga founder
    • View Profile
    • Dream of Omnimaga Music
Re: The Axe Pages
« Reply #10 on: April 10, 2010, 02:05:16 pm »
lolz :P
* DJ Omnimaga slaps Builderboy around a bit with a large trout.

Offline ACagliano

  • LV8 Addict (Next: 1000)
  • ********
  • Posts: 919
  • Rating: +32/-2
    • View Profile
    • ClrHome Productions
Re: The Axe Pages
« Reply #11 on: April 11, 2010, 12:33:31 am »
I can help in the writing of it. At least the simpler commands, or an intro perhaps. Just let me know.

Offline Quigibo

  • The Executioner
  • CoT Emeritus
  • LV11 Super Veteran (Next: 3000)
  • *
  • Posts: 2031
  • Rating: +1075/-24
  • I wish real life had a "Save" and "Load" button...
    • View Profile
Re: The Axe Pages
« Reply #12 on: April 13, 2010, 04:08:30 pm »
Okay, I downloaded openoffice and I think I get the hang of it.  I'll post a list of articles that need to be written.  Don't feel pressured to write something you don't want to becasue I'm going to be writing whatevers left over anyway.  And I'll be rewriting or rewording the articles to make them transition between each section better so don't worry about that, its the core content that's most important.

If you want to do one, post your request here.  First post first pick to avoid duplicates:

  • What is Axe Parser?  What can/can't it do?  Advantages/Disadvantages Quigibo
  • How syntax looks/Differences with TI-BASIC Quigibo
  • How to use the Parser Quigibo
  • Numbers (hex vs decimal, signed vs unsigned, 1 byte vs 2 byte)
  • Labels, Subroutines, and program flow.  Order of operations.
  • Pointers 101 What are they? How do they work?
  • Data, Memory, how to read and write to them.  Making sprites/strings/maps.
  • Reading/Writing/and creating Save Files.  How to archive/unarchive
  • How to optimize/neat tricks.
  • Writing a simple game: A tutorial. SirCmpwn

Plus there are the Individual commands.  Each one should have 1 or 2 examples and a short paragraph sized explanation.  Some commands might need more or less though depending on how complicated they are.  I'll put the list of done commands right after this:

N/A

I have to write the "Using the parser" one becasue its changing next version with new options like shell support.  When you finish one, just upload it here as an attachment.
« Last Edit: April 16, 2010, 03:40:05 am by Quigibo »
___Axe_Parser___
Today the calculator, tomorrow the world!

SirCmpwn

  • Guest
Re: The Axe Pages
« Reply #13 on: April 13, 2010, 05:20:42 pm »
I can do the simple game tutorial.

Offline DJ Omnimaga

  • Clacualters are teh gr33t
  • CoT Emeritus
  • LV15 Omnimagician (Next: --)
  • *
  • Posts: 55941
  • Rating: +3154/-232
  • CodeWalrus founder & retired Omnimaga founder
    • View Profile
    • Dream of Omnimaga Music
Re: The Axe Pages
« Reply #14 on: April 13, 2010, 05:43:20 pm »
People could actually use parts of my news article regarding Axe Parser for the description, altough some stuff might need to be changed if not accurate, since Axe got updated a lot since then. Some grammar mistakes in my description could be done too, if any.