winamp/Src/external_dependencies/openmpt-trunk/include/premake/website/docs/Sharing-Your-Module.md

34 lines
1.5 KiB
Markdown
Raw Normal View History

2024-09-24 12:54:57 +00:00
---
title: Sharing Your Module
---
## Versioning
To ensure compatibility, Premake allows project script authors to specify a minimum version or range of versions for the modules they require.
```lua
require("foo", ">=1.1")
```
To support this feature, your module should include a `_VERSION` field specifying the current version.
```lua
m._VERSION = "1.0.0" -- for the 1.0 release
m._VERSION = "1.0.0-dev" -- for the development (i.e. what's in your code repository) version
m._VERSION = "1.0.0-alpha3" -- for a pre-release version
```
When updating your version number between releases, try to follow the conventions set by the [semantic versioning](http://semver.org) standard.
## Publishing
If you intend your module to be available to the public, consider creating a new repository on [GitHub](http://github.com/) (where Premake is hosted) for it, and taking a look at some of the [existing third-party modules](/community/modules) for examples. Some tips:
* Name your repository something like `premake-modulename`
* Include a `README.md` file which explains what your module does, how to use it, and any requirements it has on other modules or libraries.
* Set up a wiki and briefly document any new features and functions it adds. See [Premake's own documentation](https://github.com/premake/premake-core/wiki) for lots of examples.
Finally, regardless of where you host it, be sure to add a link on the [Available Modules](/community/modules) page to help people find it.