From bb2f890fd470fff3e42698710b56c68164491d85 Mon Sep 17 00:00:00 2001 From: Bruce Hill Date: Sat, 29 Nov 2025 14:18:07 -0500 Subject: Overhaul to versioning system (paths go to `/tomo@TOMOVERSION/lib@LIBVERSION` instead of using underscores. Tomo versioning now uses date-based versions. --- docs/libraries.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) (limited to 'docs/libraries.md') diff --git a/docs/libraries.md b/docs/libraries.md index 79477070..fc1eb4ea 100644 --- a/docs/libraries.md +++ b/docs/libraries.md @@ -151,8 +151,7 @@ that can be used by other Tomo projects. You can build a library by running If you additionally add the `-I` flag, Tomo will copy the entire directory (excluding files and directories that begin with `.` such as `.git`) into -`~/.local/lib/tomo_vX.Y/` (where `X` and `Y` are the major/minor -version of the compiler). +`~/.local/lib/tomo@vTOMO_VERSION/LIBRARY_NAME@LIBRARY_VERSION`. ### Using Shared Libraries @@ -167,13 +166,13 @@ read from the source files during compilation. When you build and install a library, its version is determined from a `CHANGES.md` file at the top level of the library directory (see: [Versions](versions.md)). The library's version number is added to the file -path where the library is installed, so if the library `foo` has version +path where the library is installed, so if the library `mylib` has version `v1.2`, then it will be installed to -`~/.local/lib/tomo_vX.Y/foo_v1.2/`. When using a library, you must +`~/.local/lib/tomo@TOMO_VERSION/mylib@v1.2/`. When using a library, you must explicitly supply either the exact version in the `use` statement like this: -`use foo_v1.2`, or provide a `modules.ini` file that lists version information -and other details about modules being used. For each module, you should provide -a `[modulename]` section with a `version=` field. +`use mylib@v1.2`, or provide a `modules.ini` file that lists version +information and other details about modules being used. For each module, you +should provide a `[modulename]` section with a `version=` field. ```tomo # File: foo.tm -- cgit v1.2.3