|
|
| version 1.52, 2025/05/05 15:46:50 | version 1.54, 2025/05/07 19:03:06 |
|---|---|
| Line 4 | Line 4 |
| @settitle The FreeM Manual | @settitle The FreeM Manual |
| @copying | @copying |
| This manual is for FreeM, (version 0.64.0-rc1), which is a free software implementation of the M programming language. | This manual is for FreeM, (version 0.64.0), which is a free software implementation of the M programming language. |
| Print-optimized versions of this book are typeset in @emph{Computer Modern} by the author using the @emph{GNU Texinfo} tools. | Print-optimized versions of this book are typeset in @emph{Computer Modern} by the author using the @emph{GNU Texinfo} tools. |
| Line 19 Permission is granted to copy, distribut | Line 19 Permission is granted to copy, distribut |
| @title The FreeM Manual | @title The FreeM Manual |
| @subtitle @sc{The Official Manual of FreeM} | @subtitle @sc{The Official Manual of FreeM} |
| @subtitle Version 0.64.0-rc1 | @subtitle Version 0.64.0 |
| @c@vskip 10pt | @c@vskip 10pt |
| @c@center @image{freem-logo-sm,,,,.png} | @c@center @image{freem-logo-sm,,,,.png} |
| @author Serena Willis | @author Serena Willis |
| Line 100 This is the official manual for the Free | Line 100 This is the official manual for the Free |
| * Accessing FreeM from C Programs:: How to use the mlib interface. | * Accessing FreeM from C Programs:: How to use the mlib interface. |
| * FreeM Administrator:: The fmadm system manager tool. | * FreeM Administrator:: The fmadm system manager tool. |
| * FreeM Legacy Utilities:: FreeM legacy system manager utilities. | |
| * FreeM VIEW Commands and Functions:: Getting and setting info about FreeM internals. | * FreeM VIEW Commands and Functions:: Getting and setting info about FreeM internals. |
| * Implementation Limits:: FreeM limitations. | * Implementation Limits:: FreeM limitations. |
| * US-ASCII Character Set:: The US-ASCII character set. | * US-ASCII Character Set:: The US-ASCII character set. |
| Line 441 Attempting to start a FreeM interpreter | Line 440 Attempting to start a FreeM interpreter |
| The FreeM direct-mode environment is the mode entered when FreeM is invoked without the use of @option{-r @emph{<entryref>}} or @option{--routine=@emph{<entryref>}}: | The FreeM direct-mode environment is the mode entered when FreeM is invoked without the use of @option{-r @emph{<entryref>}} or @option{--routine=@emph{<entryref>}}: |
| @example | @example |
| Coherent Logic Development FreeM version 0.64.0-rc1 (x86_64-pc-linux-gnu) | Coherent Logic Development FreeM version 0.64.0 (x86_64-pc-linux-gnu) |
| Copyright (C) 2014, 2020, 2021 Coherent Logic Development LLC | Copyright (C) 2014, 2020, 2021 Coherent Logic Development LLC |
| Line 2649 In the above @emph{inclusive} form, @cod | Line 2648 In the above @emph{inclusive} form, @cod |
| @cartouche | @cartouche |
| @quotation | @quotation |
| @emph{Note} | @emph{Note} |
| The below @emph{argumentless} and @emph{exclusive} forms of @code{KSUBSCRIPTS} are not implemented in FreeM, as of version 0.64.0-rc1, but are planned for a future release. | The below @emph{argumentless} and @emph{exclusive} forms of @code{KSUBSCRIPTS} are not implemented in FreeM, as of version 0.64.0, but are planned for a future release. |
| @end quotation | @end quotation |
| @end cartouche | @end cartouche |
| Line 2684 In the above @emph{inclusive} form, @cod | Line 2683 In the above @emph{inclusive} form, @cod |
| @cartouche | @cartouche |
| @quotation | @quotation |
| @emph{Note} | @emph{Note} |
| The below @emph{argumentless} and @emph{exclusive} forms of @code{KVALUE} are not implemented in FreeM, as of version 0.64.0-rc1, but are planned for a future release. | The below @emph{argumentless} and @emph{exclusive} forms of @code{KVALUE} are not implemented in FreeM, as of version 0.64.0, but are planned for a future release. |
| @end quotation | @end quotation |
| @end cartouche | @end cartouche |
| Line 6491 int main(int argc, char **argv, char **e | Line 6490 int main(int argc, char **argv, char **e |
| @cindex fmadm | @cindex fmadm |
| The @code{fmadm} utility is the preferred method of managing a FreeM installation, and will eventually replace all of the existing utilities. | The @code{fmadm} utility is the preferred method of managing a FreeM installation, and will eventually replace all of the existing utilities. |
| Unlike the existing, legacy utilities, @code{fmadm} presents a consistent, simple interface for all FreeM management tasks, and is namespace-aware. | In support of FreeM operators, @code{fmadm} presents a consistent, simple interface for all FreeM management tasks, and is namespace-aware. |
| This appendix will document each @code{fmadm} facility as it is implemented, until all of the legacy utilities have been replaced. | This appendix will document each @code{fmadm} facility as it is implemented. |
| The @code{fmadm} utility's functions all follow the below, consistent syntax: | The @code{fmadm} utility's functions all follow the below, consistent syntax: |
| Line 6586 Supported actions are @code{list} and @c | Line 6585 Supported actions are @code{list} and @c |
| @end table | @end table |
| @node FreeM Legacy Utilities | |
| @appendix FreeM Legacy Utilities | |
| @cindex utilities, legacy | |
| @section Global Compactor (gcompact) | |
| @cindex utilities, legacy, gcompact | |
| Compacts the specified global in place. | |
| @emph{Syntax} | |
| @example | |
| gcompact @emph{/path/to/global/file} | |
| @end example | |
| @section Block Examiner (gfix) | |
| @cindex utilities, gfix | |
| The @emph{gfix} interactive utility program permits navigation of the B-tree structure of the specified global a block at a time. | |
| @emph{Syntax} | |
| @example | |
| gfix @emph{</path/to/global/file>} | |
| @end example | |
| @section Global Repair Tool (grestore) | |
| @cindex utilities, legacy, grestore | |
| This utility will fix problems with the specified global. | |
| @emph{Syntax} | |
| @example | |
| grestore @emph{</path/to/global/file>} | |
| @end example | |
| @node FreeM VIEW Commands and Functions | @node FreeM VIEW Commands and Functions |
| @appendix FreeM VIEW Commands and Functions | @appendix FreeM VIEW Commands and Functions |