PureBasic Forums - English

What is the best doc generator for PureBasic to generate
documentation from Imports, Interfaces, Procedures, Macros,
Enumerations, Modules, Structures, etc.?

Needs to be cross-platform to work on macOS.

; pbdoc Interface IX
;
; long description and example
;
; @example
; example code ...

I started the IDE and did some coding. The disk/HDD was full when
I quit the PB IDE, the currently active project file (.pbp), current file, and the
PB preferences file (.prefs) was of size 0 Bytes then.

Means, if there is a disk error, like HDD full, the PB IDE overrides
files/projects/settings ...

Is FreeBASIC good enough for MS-DOS 6.22?

A terminal/console on Windows, Linux, macOS, Raspberry PI is not the Disk Operation System that's usually called 'DOS', or in this case MS-DOS 6.22.

Works fine on macOS.

Just had to convert backslash to slash in the path to the image:
Define imgFileName.s = #PB_Compiler_Home + "examples/sources/Data/PureBasic.bmp"
and change the TextGadget color from white to another color to actually see it on the white canvas:
Define txt = TextGadget(#PB ...

In the IDE preferences we can load custom keywords from a file.

I would like to add Folding and Indentation settings for my new keywords,
but I can't load a file there.
We can load a list with custom keywords, but for folding and indentation
we have to add all entries one by one.

Would it make ...

How to fit a dialog to the size of an editorgadget or a listview ?

Editor and ListView don't have a "size to fit" because the gadgets can be empty or have thousands of lines/items.

You can set a minimum size using the width and height properties:
XML$ = "<window id='#PB_Any' name='test' text ...

Small example shows how to add a custom gadget/control to an empty Dialog container:

;
; Use Custom Gadget with Dialog Container
;
; by Danilo, 2022/05/18
;
CompilerIf #PB_Compiler_Unicode
#XmlEncoding = #PB_UTF8
CompilerElse
#XmlEncoding = #PB_Ascii
CompilerEndIf

#Dialog = 0
#Xml = 0

XML ...

You probably need to add a ContainerGadget inside the dialog and put custom controls inside the container by code, right after dialog creation.

More advanced example:

CompilerIf #PB_Compiler_Unicode
#XmlEncoding = #PB_UTF8
CompilerElse
#XmlEncoding = #PB_Ascii
CompilerEndIf

#Dialog = 0
#Xml = 0

XML$ = "<window id='#PB_Any' name='test' text='test' minwidth='600' minheight='auto' flags='#PB_Window_ScreenCentered | #PB_Window_SystemMenu ...

Using the Dialog library gives you an automatic layout system.

Simple example:
;
; http://www.purebasic.fr/english/viewtopic.php?f=13&t=56528
;
CompilerIf #PB_Compiler_Unicode
#XmlEncoding = #PB_UTF8
CompilerElse
#XmlEncoding = #PB_Ascii
CompilerEndIf

#Dialog = 0
#Xml = 0 ...

If it is always a pair of int and string, I would create a simple Macro:
Macro DataPair(_one_,_two_)
Data.i _one_
Data.s _two_
EndMacro

DataSection
mylabel:
DataPair(1,"TextABC") : DataPair(17,"SomeText")
EndDataSection

Restore mylabel
;Read.i num(1)
;Read.s txt(1)
;Read.i num(2)
;Read.s txt ...

The reason for a smaller bar width and a splitter bar without icon is using it for things like ListEx :
https://i.ibb.co/QDMzvvF/ListEx.png

On macOS I always get a separator icon, even without specifying #PB_Splitter_Separator (bug?),
and having a smaller bar (like 1 or 2 pixels) is also required ...

It would be nice to have
SetGadgetAttribute(#gadget, #PB_Splitter_BarSize, 2) ; Size (width/height) of the Splitter bar (1,2,3,4 pixels)
SetGadgetAttribute(#gadget, #PB_Splitter_DrawBarIcon, #True) ; Draw the bar icon
SetGadgetAttribute(#gadget, #PB_Splitter_DrawBarIcon, #False) ; Don't draw the ...

Little John wrote: Thu May 12, 2022 4:22 pm

Danilo wrote:The solution could be this feature request: Specify additional Include Directories
at command-line or from within the IDE.

Not in my opinion, as I wrote above.

Okay.

Little John wrote: Thu May 12, 2022 4:03 pm I don't know a solution that is better (from my point of view).

The solution could be this feature request: Specify additional Include Directories
at command-line or from within the IDE.