Hello,
Source of this is here: viewtopic.php?p=630909#p630909
Maybe you can always show the current documentation category as breadcrumbs. E.g. at the top of InitMouse show "Overview" > "2D Games & Multimedia Libraries" > "Mouse" > "InitMouse" or so.
Display the documentation category in command pages
-
- Addict
- Posts: 2345
- Joined: Mon Jun 02, 2003 9:16 am
- Location: Germany
- Contact:
Re: Display the documentation category in command pages
If you go to the section listing the functions, there is a description “Do not use the functions of this library in a regular application”.
It might be useful to make a section for sprites, as done here for World3D
It might be useful to make a section for sprites, as done here for World3D
-
- Addict
- Posts: 2345
- Joined: Mon Jun 02, 2003 9:16 am
- Location: Germany
- Contact:
Re: Display the documentation category in command pages
Exactly but as Randy mentioned it's not visible EVERYWHERE. It could be, but it's not, e.g. if you open the help via F1 while being on a specific command.AZJIO wrote: Mon Nov 18, 2024 7:08 am If you go to the section listing the functions, there is a description “Do not use the functions of this library in a regular application”.
It might be useful to make a section for sprites, as done here for World3D
bye,
Daniel
Daniel
Re: Display the documentation category in command pages
We'll end up describing the "Window" section on every gadgets page, because a beginner won't know how to use it. For others, this will be redundant information.
I don't see in the help:
1. regular expression syntax page.
2. flag (#TM_RICHTEXT) for EditorGadget to turn it into RTF.
3. Simplified and clear description of "Until 0 - endless loop" (While 1)
4. Keywords are missing in the help tree.
5. Difficult to find description of compiler command line options.
There are many more important things than duplicating the same text on all pages.
-
- Addict
- Posts: 2345
- Joined: Mon Jun 02, 2003 9:16 am
- Location: Germany
- Contact:
Re: Display the documentation category in command pages
I agree, request it, although TM_.. has nothing to do with PB itself but with Windows. Are breadcrumbs telling the answer "where in the documentation am I?" Really that lot of information that it's not worth showing? I am not saying add a disclaimer to every function saying "this is for games" or "this is for applications", but the location where you are inside the documentation.AZJIO wrote: Mon Nov 18, 2024 11:05 amThere are many more important things than duplicating the same text on all pages.
bye,
Daniel
Daniel
Re: Display the documentation category in command pages
Exception: RTF was previously used, which means users will search for information to restore the previous code. Naturally they will look for the EditorGadget function in the description. Perhaps they will look on the page for converting code 5.70 to 6.00.DarkDragon wrote: Mon Nov 18, 2024 11:18 am I agree, request it, although TM_.. has nothing to do with PB itself but with Windows
The content tree on the left always shows where you are, except for some articles and keywords that are not listed in the tree.DarkDragon wrote: Mon Nov 18, 2024 11:18 am Are breadcrumbs telling the answer "where in the documentation am I?" Really that lot of information that it's not worth showing?
Also on the page at the bottom there are links to the previous page, to the next page and to the table of contents.
-
- Addict
- Posts: 2345
- Joined: Mon Jun 02, 2003 9:16 am
- Location: Germany
- Contact:
Re: Display the documentation category in command pages
I usually browse the documentation on the web nowadays to be honest and miss it there, but yes you're right.AZJIO wrote: Mon Nov 18, 2024 11:44 amThe content tree on the left always shows where you are, except for some articles and keywords that are not listed in the tree.
Also on the page at the bottom there are links to the previous page, to the next page and to the table of contents.
bye,
Daniel
Daniel