ref: 23ab2cac2d97dd1aeec841dcaae36bdd66515f39
parent: 7e53aa3542a89d6c252b0ac21784ca8521b026d1
author: Ori Bernstein <ori@markovcorp.com>
date: Thu Mar 2 12:45:22 EST 2017
The muse manpage is no longer full of lies.
--- a/doc/muse.1
+++ b/doc/muse.1
@@ -3,30 +3,21 @@
muse
.SH SYNOPSIS
.B muse
-.I -[hmidos]
+.I -o out -p pkg [-h] [-d dbg] [-l libs]
.I [file...]
.br
.SH DESCRIPTION
.PP
-The 'muse' tool takes as input a Myrddin source file and generates
-a usefile from it. A usefile collects definitions exported from the
-package specifications in Myrddin source code, and makes them available
-for other programs to include with a 'use' statement.
-.PP
-It can also merge together a number of usefiles into one larger usefile
-including all of the exported symbols. If an output file name is not given,
-and we are not merging usefiles, then an input file named
-.I filename.myr
-will generate a usefile named
-.I filename.use
-\&.
+The muse tool acts as a linker for
+.I .use
+files. It reads all of the usefiles provided to it on the
+command line, filters them by package, and outputs a new
+usefile with the merged set of symbols. Both the
+.I -o out.use
+and the
+.I -p pkg
+options are mandatory.
-If the filename does not end with the suffix
-.I .myr
-then the suffix
-.I .o
-will simply be appended to it.
-
.PP
The output of muse is architecture-independent. However, the format of the
generated file is not stable, and is not guaranteed to work across
@@ -45,26 +36,25 @@
Print a summary of the available options.
.TP
-.B -I path
-Add 'path' to the search path for unquoted use statments. This option
-does not affect the search path for local usefiles, which are always
-searched relative to the compiler's current working directory. Without
-any options, the search path defaults to /usr/include/myr.
+.B -p package
+Take the symbols that match
+.I package
+and their dependencies, and merge them into a single package. Only symbols
+matching the package name will be reexported.
.TP
.B -o output-file
Specify that the generated usefile should be named
+.I output-file.
+By convention,
.I output-file
+should match up with the package name given to the
+.I -p
+option.
-.TP
-.B -s
-Print a summary of the symbols exported from the usefile that is specified.
-
.SH EXAMPLE
.EX
- muse foo.myr
- muse -o bar.use bar-system-version.myr
- muse -mo library foo.use bar.use
+ muse -o library.use -p library foo.use bar.use
.EE
.SH FILES