BlitzMax manual

Why not have a BlitzMax manual in the special forum there one for Blitz3d and BlitzPlus

Maybe they can work on it now they've released the Blitz3D book.

I think the documentation that comes with BlitzMax is mostly okay, but it doesn't explain things enough. When I think back to like the AMOS Basic manual, several years ago on the Amiga, it explained a lot of programming concepts rather than just give a list of commands.

Or even just the original Spectrum manual. (No not the tiny latter ones)

The C64 manual was great as well... ;)

Anyway I agree that the current bmx manual lacks examples (+ superstrict) and descriptions.

No what I meant was at the bottom of the forums list there is 'Special Forums' this has Code archives, Blitz Plus manual and Blitz3d manua. What I was asking is why not have a BlitzMax manual there.

Blitzmax has a manual?

Where did they hide this little gem?

/me thinks back

Oh yeah, it was broken up, encrypted, and mixed in with the help docs right? So every 3rd letter of the help docs is part of the manual?!?

/me gets out his pen and paper and pours through the help docs looking for some sign.

Nah I wondered if they could add the forum to the special section, this way at least there would be some samples of code etc.

BRL why not have a BlitzMax Manual at the bottom of the forum just like there is a version for all the other Blitz's?

my attempt to do something like that
http://www.graphio.net/20/index.php

It looks like a 'copy' of the BlitzMax manual, what I thought would be a good idea is when people have a small demo for a command it could be posted onto the BlitzMax manual forum so people wouldnt have to do an 'extensive' forum search to locate a simple demo for each command. Lets face it the BlitzMax manual doesnt do much in the way of demonstrating the networking side of BlitzMax and most of the other commands are lacking examples.

Ahhhh,

Ive spoted the problem. Edzup, no one else thinks of those docs as a manual

I do, it's just not a great manual.

A programming manual for any language should have some decent examples that at least explain what the command does and how it does it, this usually comes with complete syntax and a small example.

I've had a thought, what about google docs?

It allows collaboration, docs can be published to the web but only editable by those granted permission.

i.e.: http://docs.google.com/View?docID=dmx784d_5hbtftk&revision=_latest

Mark will we have a BlitzMax manual forum? I see you have added the SDK forum and was wondering about the BlitzMax manual forum?

Ahhh, but there is a Sdk to have a forum about, but there isnt a manual

No, you won't. The BlitzMax documentation is generated by a tool based upon the BlitzMax source code, and every time a module is modified it can change. As such, maintaining a forum for the commands/etc. of BlitzMax would be incredibly difficult considering that just BRL's modules can change enough that it would make maintaining the forum very difficult.

So the answer is no, you won't get a forum about it.

I thought a forum that explains the changes between modules and allow BlitzMax users to post source code examples for the commands would have been a good idea. It would be much much better than trawling through the forums with the search function and the code archives only to find there isnt an example, much like the documentation actually most if not all of the commands arent documented properly (if a function returns something some of them arent documented as to what it returns, most of that is trial and error which shouldnt be the case in documentation).

Im just asking for an area of the forum that BlitzMax users can post examples to the commands and give much better explainations of the commands available.

That would be called the Tutorials forum.