Howto manual
-
BackupUser
- PureBasic Guru

- Posts: 16777133
- Joined: Tue Apr 22, 2003 7:42 pm
-
BackupUser
- PureBasic Guru

- Posts: 16777133
- Joined: Tue Apr 22, 2003 7:42 pm
Restored from previous forum. Originally posted by Stan.
someone must maintain a list of person(s) working on one topic, in order to
avoid duplicate efforts ... ( and bad ego problems !!! ).
I would suggest the following breakdown for Chapter 1 & 2 :
- Intro and hype about PB, ( FRED will gladly do that )
- What is a program ( I can take it )
- Variable and constants ( basic types, structured types ... ) ( I can take
it )
- PB. Keywords ( including operators and precedence ... )
- Your first program
- Programming structures ( Loops, Procedures ... )
- Programming styles ( tips on how to make your programs easier to
understand ... ) ( I have some ideas ... )
I surely forgot many things, feel free to elaborate and critisize ...
Learning and Love are what life is all about ... [ PB. registered user ]
That's fine : can we begin to try to find out who will do what, I mean that
Ls,
Ok guys. As promised the shooting list. This is intended as a first step. So give your comments please and feel free to add/ remove chapters/items.
...
Rgrds,
Rick Denkers
"Mensen struikelen niet over bergen, maar over molshopen."
Confucius
someone must maintain a list of person(s) working on one topic, in order to
avoid duplicate efforts ... ( and bad ego problems !!! ).
I would suggest the following breakdown for Chapter 1 & 2 :
- Intro and hype about PB, ( FRED will gladly do that )
- What is a program ( I can take it )
- Variable and constants ( basic types, structured types ... ) ( I can take
it )
- PB. Keywords ( including operators and precedence ... )
- Your first program
- Programming structures ( Loops, Procedures ... )
- Programming styles ( tips on how to make your programs easier to
understand ... ) ( I have some ideas ... )
I surely forgot many things, feel free to elaborate and critisize ...
Learning and Love are what life is all about ... [ PB. registered user ]
-
BackupUser
- PureBasic Guru

- Posts: 16777133
- Joined: Tue Apr 22, 2003 7:42 pm
Restored from previous forum. Originally posted by Stan.
with the program (changing "Hello world" to "Bye All", is no fun ... ),
he must also have a feel about the power of PB, and if possible add new
functions and capabilities to the program as he becomes more familiar with
PB and programming.
I thought about something : a robot program,
First stage : Dumb robot, it starts from home then go to various places
(when reaching a new destination, print on the console "I am at location x"),
then comes back home, not very exciting but can be an introduction to variables,
tables, and some basic keywords, and For next loop
Second stage : Dumb robot which does something : each time it reaches a new
place it picks up something (prints "I am at location x and picked 10 kg"),
could be an introduction to structures,
Third stage : Half Smart robot : when the weight of the items it picked up is
over a given limit he comes back home and unload before continuing its trip
(prints ... ), could be an introduction do decision structures ( If, While ...),
Fourth Stage : 3/4 smart robot : when in one place, check if going to the next
one will lead to overloading, and comes back home if needed (prints ... ), could
be an introduction to lists,
Fifth stage : 8/10 smart robot : when in one place and the going to the next one
means overloading, check if there is an other place not yet visited where he
could pick an item before coming back, introducing procedures could be done
there,
Sixth stage : 9/10 smart robot : when in one place and the going to the next one
means overloading, find the "best" place not yet visited where he could
pick an item before coming back, ("Best" could be either defined as the nearest
one, or the one which maximize the load which could lead to Switch based on
an user defined strategy ... ),
Seventh Stage : add fancy features to each of the first six stage (for instance
from stage 2 onward, print using message requester, from stage 3 onward display
the robot as a point moving, from stage 4 onward display the robot as a sprite,
from stage 5 onward add some sound ... you get the idea.
Comments welcomed ....
Bests.
Stan
Learning and Love are what life is all about ... [ PB. registered user ]
I do agree "Hello world" is a bit limited, the user should be able to play...
In this first chapter, we will do a quick overview of what (Pure) basic is all about.
You will start programming an application in Pure Basic. You'll learn a new vocabulary, a new approach to programming, and ways to move around in the Pure Basic environment. Our aim is to teach you programming from the very first chapter with examples.
( Lets give an original example here and not the "hello world " example !)
...
Rick Denkers
"Mensen struikelen niet over bergen, maar over molshopen."
Confucius
with the program (changing "Hello world" to "Bye All", is no fun ... ),
he must also have a feel about the power of PB, and if possible add new
functions and capabilities to the program as he becomes more familiar with
PB and programming.
I thought about something : a robot program,
First stage : Dumb robot, it starts from home then go to various places
(when reaching a new destination, print on the console "I am at location x"),
then comes back home, not very exciting but can be an introduction to variables,
tables, and some basic keywords, and For next loop
Second stage : Dumb robot which does something : each time it reaches a new
place it picks up something (prints "I am at location x and picked 10 kg"),
could be an introduction to structures,
Third stage : Half Smart robot : when the weight of the items it picked up is
over a given limit he comes back home and unload before continuing its trip
(prints ... ), could be an introduction do decision structures ( If, While ...),
Fourth Stage : 3/4 smart robot : when in one place, check if going to the next
one will lead to overloading, and comes back home if needed (prints ... ), could
be an introduction to lists,
Fifth stage : 8/10 smart robot : when in one place and the going to the next one
means overloading, check if there is an other place not yet visited where he
could pick an item before coming back, introducing procedures could be done
there,
Sixth stage : 9/10 smart robot : when in one place and the going to the next one
means overloading, find the "best" place not yet visited where he could
pick an item before coming back, ("Best" could be either defined as the nearest
one, or the one which maximize the load which could lead to Switch based on
an user defined strategy ... ),
Seventh Stage : add fancy features to each of the first six stage (for instance
from stage 2 onward, print using message requester, from stage 3 onward display
the robot as a point moving, from stage 4 onward display the robot as a sprite,
from stage 5 onward add some sound ... you get the idea.
Comments welcomed ....
Bests.
Stan
Learning and Love are what life is all about ... [ PB. registered user ]
-
BackupUser
- PureBasic Guru

- Posts: 16777133
- Joined: Tue Apr 22, 2003 7:42 pm
Restored from previous forum. Originally posted by DarkUni.
I wrote a beginner's guide to game writing in DIV (yet another language - DOS based, shame). It was my first commissioned and paid technical writing - I'm actually quite pleased with it. Here is a link:
http://www.div-arena.com/DIVQSG1.0.zip
Even a couple years later, I still get 2 or 3 emails a month asking for another one of these.
Would there be enough interest in me retooling this into Pure Basic?
Shane R. Monroe, Dark Unicorn Productions
Pure Basic Basement
http://pb.darkunicornproductions.com
I wrote a beginner's guide to game writing in DIV (yet another language - DOS based, shame). It was my first commissioned and paid technical writing - I'm actually quite pleased with it. Here is a link:
http://www.div-arena.com/DIVQSG1.0.zip
Even a couple years later, I still get 2 or 3 emails a month asking for another one of these.
Would there be enough interest in me retooling this into Pure Basic?
Shane R. Monroe, Dark Unicorn Productions
Pure Basic Basement
http://pb.darkunicornproductions.com
-
BackupUser
- PureBasic Guru

- Posts: 16777133
- Joined: Tue Apr 22, 2003 7:42 pm
Restored from previous forum. Originally posted by rdenkers.
Confucius
"Mensen struikelen niet over bergen, maar over molshopen."I do agree "Hello world" is a bit limited, the user should be able to play...
In this first chapter, we will do a quick overview of what (Pure) basic is all about.
You will start programming an application in Pure Basic. You'll learn a new vocabulary, a new approach to programming, and ways to move around in the Pure Basic environment. Our aim is to teach you programming from the very first chapter with examples.
( Lets give an original example here and not the "hello world " example !)
...
Rick Denkers
"Mensen struikelen niet over bergen, maar over molshopen."
Confucius
with the program (changing "Hello world" to "Bye All", is no fun ... ),
he must also have a feel about the power of PB, and if possible add new
functions and capabilities to the program as he becomes more familiar with
PB and programming.
I thought about something : a robot program,
First stage : Dumb robot, it starts from home then go to various places
(when reaching a new destination, print on the console "I am at location x"),
then comes back home, not very exciting but can be an introduction to variables,
tables, and some basic keywords, and For next loop
Second stage : Dumb robot which does something : each time it reaches a new
place it picks up something (prints "I am at location x and picked 10 kg"),
could be an introduction to structures,
Third stage : Half Smart robot : when the weight of the items it picked up is
over a given limit he comes back home and unload before continuing its trip
(prints ... ), could be an introduction do decision structures ( If, While ...),
Fourth Stage : 3/4 smart robot : when in one place, check if going to the next
one will lead to overloading, and comes back home if needed (prints ... ), could
be an introduction to lists,
Fifth stage : 8/10 smart robot : when in one place and the going to the next one
means overloading, check if there is an other place not yet visited where he
could pick an item before coming back, introducing procedures could be done
there,
Sixth stage : 9/10 smart robot : when in one place and the going to the next one
means overloading, find the "best" place not yet visited where he could
pick an item before coming back, ("Best" could be either defined as the nearest
one, or the one which maximize the load which could lead to Switch based on
an user defined strategy ... ),
Seventh Stage : add fancy features to each of the first six stage (for instance
from stage 2 onward, print using message requester, from stage 3 onward display
the robot as a point moving, from stage 4 onward display the robot as a sprite,
from stage 5 onward add some sound ... you get the idea.
Comments welcomed ....
Bests.
Stan
Learning and Love are what life is all about ... [ PB. registered user ]
Confucius
-
BackupUser
- PureBasic Guru

- Posts: 16777133
- Joined: Tue Apr 22, 2003 7:42 pm
Restored from previous forum. Originally posted by rdenkers.
Excellent idea !
maybe we can use your robot idea as the general concept of the book .
Anyone (dis)agree ?
Rick
quote]
with the program (changing "Hello world" to "Bye All", is no fun ... ),
he must also have a feel about the power of PB, and if possible add new
functions and capabilities to the program as he becomes more familiar with
PB and programming.
I thought about something : a robot program,
First stage : Dumb robot, it starts from home then go to various places
(when reaching a new destination, print on the console "I am at location x"),
then comes back home, not very exciting but can be an introduction to variables,
tables, and some basic keywords, and For next loop
Second stage : Dumb robot which does something : each time it reaches a new
place it picks up something (prints "I am at location x and picked 10 kg"),
could be an introduction to structures,
Third stage : Half Smart robot : when the weight of the items it picked up is
over a given limit he comes back home and unload before continuing its trip
(prints ... ), could be an introduction do decision structures ( If, While ...),
Fourth Stage : 3/4 smart robot : when in one place, check if going to the next
one will lead to overloading, and comes back home if needed (prints ... ), could
be an introduction to lists,
Fifth stage : 8/10 smart robot : when in one place and the going to the next one
means overloading, check if there is an other place not yet visited where he
could pick an item before coming back, introducing procedures could be done
there,
Sixth stage : 9/10 smart robot : when in one place and the going to the next one
means overloading, find the "best" place not yet visited where he could
pick an item before coming back, ("Best" could be either defined as the nearest
one, or the one which maximize the load which could lead to Switch based on
an user defined strategy ... ),
Seventh Stage : add fancy features to each of the first six stage (for instance
from stage 2 onward, print using message requester, from stage 3 onward display
the robot as a point moving, from stage 4 onward display the robot as a sprite,
from stage 5 onward add some sound ... you get the idea.
Comments welcomed ....
Bests.
Stan
Learning and Love are what life is all about ... [ PB. registered user ]
[/quote]
"Mensen struikelen niet over bergen, maar over molshopen."
Confucius
Excellent idea !
maybe we can use your robot idea as the general concept of the book .
Anyone (dis)agree ?
Rick
quote]
I do agree "Hello world" is a bit limited, the user should be able to play...
In this first chapter, we will do a quick overview of what (Pure) basic is all about.
You will start programming an application in Pure Basic. You'll learn a new vocabulary, a new approach to programming, and ways to move around in the Pure Basic environment. Our aim is to teach you programming from the very first chapter with examples.
( Lets give an original example here and not the "hello world " example !)
...
Rick Denkers
"Mensen struikelen niet over bergen, maar over molshopen."
Confucius
with the program (changing "Hello world" to "Bye All", is no fun ... ),
he must also have a feel about the power of PB, and if possible add new
functions and capabilities to the program as he becomes more familiar with
PB and programming.
I thought about something : a robot program,
First stage : Dumb robot, it starts from home then go to various places
(when reaching a new destination, print on the console "I am at location x"),
then comes back home, not very exciting but can be an introduction to variables,
tables, and some basic keywords, and For next loop
Second stage : Dumb robot which does something : each time it reaches a new
place it picks up something (prints "I am at location x and picked 10 kg"),
could be an introduction to structures,
Third stage : Half Smart robot : when the weight of the items it picked up is
over a given limit he comes back home and unload before continuing its trip
(prints ... ), could be an introduction do decision structures ( If, While ...),
Fourth Stage : 3/4 smart robot : when in one place, check if going to the next
one will lead to overloading, and comes back home if needed (prints ... ), could
be an introduction to lists,
Fifth stage : 8/10 smart robot : when in one place and the going to the next one
means overloading, check if there is an other place not yet visited where he
could pick an item before coming back, introducing procedures could be done
there,
Sixth stage : 9/10 smart robot : when in one place and the going to the next one
means overloading, find the "best" place not yet visited where he could
pick an item before coming back, ("Best" could be either defined as the nearest
one, or the one which maximize the load which could lead to Switch based on
an user defined strategy ... ),
Seventh Stage : add fancy features to each of the first six stage (for instance
from stage 2 onward, print using message requester, from stage 3 onward display
the robot as a point moving, from stage 4 onward display the robot as a sprite,
from stage 5 onward add some sound ... you get the idea.
Comments welcomed ....
Bests.
Stan
Learning and Love are what life is all about ... [ PB. registered user ]
[/quote]
"Mensen struikelen niet over bergen, maar over molshopen."
Confucius
-
BackupUser
- PureBasic Guru

- Posts: 16777133
- Joined: Tue Apr 22, 2003 7:42 pm
Restored from previous forum. Originally posted by naw.
How about building the tutorial with the PB based "Atomic Web Server" in mind - this would allow fancy searches and dynamic cross-references - ie the index could be built according to the local file and directory structure of individual HTML files. New HTML files could then be added ad-hoc into the appropriate directories and hey-presto! as if by magic, they appear in the right place in the index and are searchable as well.
I've done this sort of thing before on my AIX(Unix) Desktop at work and it works well (unfortunately its all ksh based).
Personally, I find it difficult to keep track of documentation (things disappear) and this would make a fine document repository.
Having often been required to produce collaborative documents, I agree that a simple text format would be easiest to accomplish re-formatting documents produced in various WPs and different fonts and styles is time-consuming and tedious. I suggest that simple HTML1.0 with seperate referenced CSS Style sheets be used to *present* the final version.
I'd love to help as well, but my PB is not so good (I'm learning and I'm a casual programmer) I'd probably be more of a hinderance than a help
How about building the tutorial with the PB based "Atomic Web Server" in mind - this would allow fancy searches and dynamic cross-references - ie the index could be built according to the local file and directory structure of individual HTML files. New HTML files could then be added ad-hoc into the appropriate directories and hey-presto! as if by magic, they appear in the right place in the index and are searchable as well.
I've done this sort of thing before on my AIX(Unix) Desktop at work and it works well (unfortunately its all ksh based).
Personally, I find it difficult to keep track of documentation (things disappear) and this would make a fine document repository.
Having often been required to produce collaborative documents, I agree that a simple text format would be easiest to accomplish re-formatting documents produced in various WPs and different fonts and styles is time-consuming and tedious. I suggest that simple HTML1.0 with seperate referenced CSS Style sheets be used to *present* the final version.
I'd love to help as well, but my PB is not so good (I'm learning and I'm a casual programmer) I'd probably be more of a hinderance than a help
-
BackupUser
- PureBasic Guru

- Posts: 16777133
- Joined: Tue Apr 22, 2003 7:42 pm
Restored from previous forum. Originally posted by SimpleMind.
Hi,
I'm new here and followed PB for more than a year. I just got my registered full version today.
Discussion
I followed this discussion and I find it a good idea so let me join if you want. What I've read here is already far too complex and too overwhelming to me as a starter in PB. IMHO we have to build the "How To" manual in stages and small pieces (modularity). I like the idea to build a manual along a concept as an atomic web/ftp-server but we have to be cautious. Maybe we can split up the team in novice, regular and guru units. Each unit has a poweruser to steer the group and who delivers the code the group asks.
What do we have.
What I've seen of the PB-help I like it but misses the code examples, e.g. I see #Constants used in PB-code but can't place them in the context (no knowledge of PB), I see functions but they are to minimalistic commented (no inside information). At this time I have to gues what they might do, whith the experience of my VBA(Word) (pascal, C, Euphoria) and common knowledge in mind.
Programming
I read also that some people want to write or want to know more about programming. I know a good book that can be used as a good example for programming. The outline of this book is already used for C and Python and embrassed by teachers at universities. Take this as an example and put PB-code examples in it. Don't invent the wheel again.
So far my add.
If I don't sleep I'm awake.
Marcel Kollenaar
"We cannot solve the problem at the same level at which we created them."
Albert Einstein.
Happy coder with some knowlegde of basic, c, euphoria, vba-word and always searching for simple programming languages and humor. KISS (keep it simple and smart).
Hi,
I'm new here and followed PB for more than a year. I just got my registered full version today.
Discussion
I followed this discussion and I find it a good idea so let me join if you want. What I've read here is already far too complex and too overwhelming to me as a starter in PB. IMHO we have to build the "How To" manual in stages and small pieces (modularity). I like the idea to build a manual along a concept as an atomic web/ftp-server but we have to be cautious. Maybe we can split up the team in novice, regular and guru units. Each unit has a poweruser to steer the group and who delivers the code the group asks.
What do we have.
What I've seen of the PB-help I like it but misses the code examples, e.g. I see #Constants used in PB-code but can't place them in the context (no knowledge of PB), I see functions but they are to minimalistic commented (no inside information). At this time I have to gues what they might do, whith the experience of my VBA(Word) (pascal, C, Euphoria) and common knowledge in mind.
Programming
I read also that some people want to write or want to know more about programming. I know a good book that can be used as a good example for programming. The outline of this book is already used for C and Python and embrassed by teachers at universities. Take this as an example and put PB-code examples in it. Don't invent the wheel again.
So far my add.
If I don't sleep I'm awake.
Marcel Kollenaar
"We cannot solve the problem at the same level at which we created them."
Albert Einstein.
Happy coder with some knowlegde of basic, c, euphoria, vba-word and always searching for simple programming languages and humor. KISS (keep it simple and smart).
I also hope this project is not dead. (Although I realise how valuable free/spare time can be.)
Suggestion :
Maybe the MS "Duwamish Books" sample application (Phase 1, maybe phase 2) is a good target for the end result of the whole book :
Duwamish Books Sample application, Sept 1999
Duwamish Online Sample application, Jul 2000
I hope we achieve 2 things with this :
1) Learn alot of PB down the way
(While I'm not new to programming (IBM AS/400, RPG, COBOL, CL), I am new to programming on the PC.)
2) That it will proof how much smaller, more efficient, and faster PB is over VB.
I can only hope for this to happen, because I ordered my copy of PB last Tuesday by snail mail and I am waiting for the download link.
(For God's sake, hurry up mailman ! France is not that far !)
So I do not have PB and VB in my possesion, nor the knowledge of either to make a fair comparison.
Teach me !
Suggestion :
Maybe the MS "Duwamish Books" sample application (Phase 1, maybe phase 2) is a good target for the end result of the whole book :
Duwamish Books Sample application, Sept 1999
Duwamish Online Sample application, Jul 2000
I hope we achieve 2 things with this :
1) Learn alot of PB down the way
(While I'm not new to programming (IBM AS/400, RPG, COBOL, CL), I am new to programming on the PC.)
2) That it will proof how much smaller, more efficient, and faster PB is over VB.
I can only hope for this to happen, because I ordered my copy of PB last Tuesday by snail mail and I am waiting for the download link.
(For God's sake, hurry up mailman ! France is not that far !)
So I do not have PB and VB in my possesion, nor the knowledge of either to make a fair comparison.
Teach me !
