Is there a way to get the full online manual... offline?
I want to read it on my iPhone.
This is all that I can find, it's basically just the Commands:
GLBasic Commands PDF (http://glbasic.un-map.com/GLBasic.pdf)
To export the GLB Help Manual to a pdf
Install a pdf creator like dopdf (www.dopdf.com)
Then open the helpfile, Right Click on a category i.e. Tutorials, click Print,
Select Print the selected Heading and all Subtopics, then choose dopdf
as your printer, give it a name and you'll have a pdf of the tutorials.
It you mean the help file in GLBasic, it sucks.
It has around half the commands supported by GLB.
It is doing more damage than benefict. Please, remove the help file/chm form GLBasic! Keep only the online html one!
QuoteIt is doing more damage than benefict.
You obviously haven't see the documentation for BlitzMax then. Go have a play with that and come back and repeat your statement! :P
I'd say the most up to date error free manual would be
http://wiki.just-do-i-t.com/
MrTAToad has been working hard updating it for the past few days/weeks
Although printing it is another matter, can't you just access it from your iphone online
QuoteYou obviously haven't see the documentation for BlitzMax then
I always loved the Blitzbasic/Plus help file, very simple, easy to access what you
want, Blitmax, there's not even a search option, it's a nightmare
Quote from: Ian Price on 2010-Sep-17
QuoteIt is doing more damage than benefict.
You obviously haven't see the documentation for BlitzMax then. Go have a play with that and come back and repeat your statement! :P
I did never do the jump to BM, I just was a Blitz3D guy. With a printed manual and a programming guide printed! Wooot!
I guess I am lucky, I have never found any issues with GLB's help file.
The help file, for example, does not have LEFT or RIGHT commands listed.
And so more commands are missing.
Anything else?
I HAVE TO BEG PERDON!!!!!
I FIRST CHECKED THE HELP FILE ON VERSION 7
AGAIN, I BED PERDON!!!!
QuoteI always loved the Blitzbasic/Plus help file, very simple, easy to access what you
want, Blitmax, there's not even a search option, it's a nightmare
You're not wrong. The manuals for BlitzBasic and Blitz3D were ace. I still can't understand why Max's help system/documentation is so shite.
QuoteIt has around half the commands supported by GLB
Not exactly - a lot of the commands are grouped together on one page - the network commands being an example.
It is very tempting to convert the Wiki to book form using Blurb (a company for making & publishing your own books). The questions to be asked is :
Is there a need ?
Will people buy it ?
Quote from: ampos on 2010-Sep-17
The help file, for example, does not have LEFT or RIGHT commands listed.
And so more commands are missing.
Anything else?
I am sorry that you find GLB too advanced for your needs.
QuoteWill people buy it ?
I'm really not sure there is a need for paper manuals nowadays. If users can't work out the inline and online documentation, there is always this forum. And MrTAToad, you seem to be available to answer pretty much everything 25hours a day, 8 days a week! :P And if it's a bug, Gernot fixes it (generally) within a day. :)
That's why I love GLB.
Quote from: MrTAToad on 2010-Sep-17
Will people buy it ?
I already have the manual printed, so I would not be interested. I likely wouldn't be able to afford it anyway.
Quote from: Ian Price on 2010-Sep-17
QuoteWill people buy it ?
I'm really not sure there is a need for paper manuals nowadays. If users can't work out the inline and online documentation, there is always this forum. And MrTAToad, you seem to be available to answer pretty much everything 25hours a day, 8 days a week! :P And if it's a bug, Gernot fixes it (generally) within a day. :)
That's why I love GLB.
It's one advantage to being unemployed :)
The other problem with manuals (other than the price) is that they get outdated, especially with Gernot around. Bugs are quashed quite quickly and commands are introduced, or altered to fit the need of the user. What might be accurate in print today, may not be when GLB has a new update.
Quote from: Ian Price on 2010-Sep-17
The other problem with manuals (other than the price) is that they get outdated, especially with Gernot around. Bugs are quashed quite quickly and commands are introduced, or altered to fit the need of the user. What might be accurate in print today, may not be when GLB has a new update.
MrTAToad should write each book by hand with a pencil. This way anytime something changes the person who buys the book can simply erase the outdated info and write in the new info. A few blank pages would give a place for users to write in info for new commands =D
QuoteMrTAToad should write each book by hand with a pencil. This way anytime something changes the person who buys the book can simply erase the outdated info and write in the new info.
LOL.
This is the advantage to a web-based manual - especailly the Wikki, where any one of us can update it and one could presumably print out the whole thing or only pages which have changed.
We have to be a bit proactive though - I'm finding occasions where I think the Wikki could be clearer, or have more information, and trying to edit it to include that. If EVERYONE who has an issue with the documentation could update the Wikki then it would very quickly surpass the online manual, I think, and even MrTAToad's command list.
I'm a newbie here, but an oldie on the planet, so I straddle the line of those who might be expected to say the manual sucks. I'd prefer to say that the official documentation - even the online manual - leaves a great deal to be desired, but that firmly puts me in the "not content" camp I believe. If it can be improved by the community - why not? Only the community (and Gernot) stand to benefit.
QuoteMrTAToad should write each book by hand with a pencil
Would get through a lot :)
It would be nice if everyone checked the details on the Wiki - making sure its all correct
QuoteThis is the advantage to a web-based manual - especailly the Wikki, where any one of us can update it and one could presumably print out the whole thing or only pages which have changed.
I am not a fan of online manuals, mainly because dev machine does not (and never will) have an online connection.
Quote from: Kuron on 2010-Sep-17
QuoteThis is the advantage to a web-based manual - especailly the Wikki, where any one of us can update it and one could presumably print out the whole thing or only pages which have changed.
I am not a fan of online manuals, mainly because dev machine does not (and never will) have an online connection.
Ah! But an online manual should be easy to rip and put offline. An offline manual...is harder to do the same with, and it's harder to share editing duties :(
The chm manual you get in the editor is a copy of the online version. I create that with every update.
What I'm thinking about doing is making small reference guide like some of the O'Reilly. I like to have something small that I can pick up, flip to that command that I need the information for and get it running.
I'm actually working on something similar - to keep costs (apparently) down, I'll probably do it in two volume - a user guide and a reference guide.
If ol' Cliff3D doesn't mind, I'll include his bits too...
Quote from: MrTAToad on 2010-Sep-17
If ol' Cliff3D doesn't mind, I'll include his bits too...
Absolutely :) nothing beats a good manual, and I'm all for understanding this language :)
Quote from: Kitty Hello on 2010-Sep-17
The chm manual you get in the editor is a copy of the online version. I create that with every update.
I know and that is why I do not get the kid who is whining that it sucks and is missing half the commands that the online version has ;/