Adding new modules to OSLib

[Justin F]

On Wed, 29 Sep 2021, W P Blatchley wrote:

> Hello OSLibers,
> 
> I'm sure this must be mentioned in the documentation somewhere, but I've read
> all I can find and I haven't spotted it.
> 
> Are there instructions for adding new modules to OSLib anywhere? I'd like to
> add some.

What sort of instructions are you thinking of?

Did you mean instructions for the fileformat and what each of the fields 
means?
  - I'm not actually sure where this is documented. I had to read lots of 
    examples and the source code in order to write my own parser for it.
    It also is very poorly documented what the fileformat is parseable,
    but if you need more example code that's probably as inpenetrable as
    the C code, it's here: 
        https://github.com/gerph/riscos-oslib-parser
    However, my suggestion is to try to look at the existing def files and 
    see that they look like they have similar APIs and pinch bits from 
    them :-(

Or where they go?
  - Usually the modules will go in the User subdirectory, unless they're
    part of RISC OS itself.

Or did you mean how you build it?
  - The file !OSLib.docs.OSLib_readme contains some instructions on how to 
    build it with GCC.

Or maybe how to submit them?
  - I guess send them to this mailing list and the maintainer will get 
    around to it. This is a low traffic list, and there's usually some lag 
    in getting replies because it's not anyone's even part time job :-)

Hope that helps, but if not someone else may have better ideas.

-- 
Charles Justin Ferguson
[ All information, speculation, opinion or data within, or attached to,
  this email is private and confidential. Such content may not be
  disclosed to third parties, or a public forum, without explicit
  permission being granted. ]