Update .github/ISSUE_TEMPLATE/what_people_are_saying.yml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Bill Stumbo <wstumbo@charter.net>

.github/ISSUE_TEMPLATE/primer.yml

@@ -0,0 +1,68 @@
+name: Report an issue with the "Medley Interlisp for the Newcomer" primer
+description: Use this template to report issues or make suggestions.
+title: "[Primer] <short title here>"
+labels: 
+  - primer
+  - documentation
+body:
+  - type: dropdown
+    id: problemType
+    attributes:
+      label: "What type of issue are you reporting?"
+      options:
+        - Suggested improvement
+        - Incorrect explanation / code sample
+        - Confusing explanation
+        - Outdated information
+        - Broken link
+        - Typo / Grammar
+    validations:
+      required: true
+  - type: dropdown
+    id: location
+    attributes:
+      label: "Section of the primer where the issue occurs"
+      options:
+        - Introduction
+        - Medley online and Medley Local
+        - Understanding and Navigating the Interface
+        - Understanding Lisp Syntax
+        - Atoms, Functions and Lists
+        - Variable Bindings and Scope
+        - Iterators and Conditionals
+        - The File Browser
+        - Debugging
+        - Editing functions with SEdit
+        - Build Your First Interactive Program
+        - Saving Your Work
+        - TEdit, The WYSIWYG Editor
+        - Drawing and Displaystreams
+        - Making a Graph with Grapher
+        - Additional Resources
+        - General Feedback (not specific to a section)
+    validations:
+      required: true
+  - type: textarea
+    id: issueLocationDetails
+    attributes:
+      label: "Please provide more details about the location of the issue"
+      description: "For example, the specific page title, section heading, or url."
+    validations:
+      required: false
+  - type: textarea
+    id: issueDescription
+    attributes:
+      label: "Description of the issue"
+      description: "Please provide a detailed description of the issue you encountered."
+    validations:
+      required: true
+  - type: textarea
+    id: suggestedFix
+    attributes:
+      label: "Suggested fix or improvement"
+      description: "If you have a suggestion for how to fix or improve the issue, please provide it here."
+    validations:
+      required: false
+  - type: markdown
+    attributes:
+      value: "## Thank you for helping us improve the **Medley Interlisp for the Newcomer** primer!"

.github/ISSUE_TEMPLATE/what_people_are_saying.yml

@@ -1,6 +1,6 @@
-name: "New entry for **What People Are Saying**"
-description: "Suggest a new entry for the **What People are Saying** page"
-title: "What People are Saying suggestion"
+name: New "What People Are Saying" entry
+description: 'Suggest a new entry for the "What People Are Saying" page'
+title: "What People Are Saying suggestion"
 body:
   - type: dropdown
     id: contentType
@@ -24,7 +24,7 @@ body:
     id: additionalInformation
     attributes:
       label:  Additional information
-      description: "Use this space to supply any addiitonal information on the suggested item."
+      description: "Use this space to supply any additional information on the suggested item."
     validations:
       required: false
   - type: markdown

.gitignore

@@ -31,6 +31,9 @@ loadups/whereis.hash
 loadups/apps.sysout
 loadups/fuller.database
 loadups/build/
+loadups/branches
+loadups/gitinfo
+
 
 # manual cross-reference files
 

CONTRIBUTING.md

@@ -3,7 +3,7 @@
 First, we want to thank you for helping reach the goal of restoring Medley Interlisp
 to the point where it is as useful today as it was 30 years ago.
 
-This guide is meant to help you make useful contributions, whether to the [Maiko](https://github.com/Interlisp/maiko) C-based virtual machine implementation, the [Medley](https://github.com/Interlisp/medley) Lisp code (in Interlisp and Common Lisp), or [documentation](https://github.com/Interlisp/medley/wiki). There are a number of [GitHub](https://github.com/Interlisp/medley/discussions/categories/github-use) problems that could use some attention.
+This guide is meant to help you make useful contributions, whether to the [Maiko](https://github.com/Interlisp/maiko) C-based virtual machine implementation, the [Medley](https://github.com/Interlisp/medley) Lisp code (in Interlisp and Common Lisp), or [documentation](https://interlisp.org/software/using-medley). There are a number of [GitHub](https://github.com/Interlisp/medley/discussions/categories/github-use) problems that could use some attention.
 
 ## Working with Maiko
 
@@ -17,6 +17,8 @@ The current arrangement of files and extentions is awkward for working on the im
 * The most useful contributions are reproducible errors -- things that don't work as documented.
 * Second most useful are reports of unexpected behavior -- things that aren't documented but behave unexpectedly.
 
+To report these errors and behaviors [open an issue](https://github.com/Interlisp/medley/issues).
+
 ## Reporting a bug or feature request
 * Ensure the bug was not already reported by searching on GitHub under [Issues](https://github.com/Interlisp/medley/issues) or [Discussions](https://github.com/Interlisp/medley/discussions). Note that all issues and Discussions are found in the Medley repository, using labels to distinguish. Discussions are for questions or topics where there is some disagreement or uncertainty about the "right" direction.
 * If you're unable to find a discussion or open issue addressing the problem, open a new one. Be sure to include a title 
@@ -24,7 +26,7 @@ and clear description, as much relevant information as possible. Use the issue t
 
 ## Did you write a patch that fixes a bug?  
 * Some bug fixes and "improvements" have unintended consequences, well beyond what you might expect for well-written modern code. We don't have testing new builds automated or integrated. Be sure you've tested your patch.
-* Open a new [GitHub pull request](https://github.com/Interlisp/maiko/pulls) with the patch.
+* Open a new GitHub pull request with the patch.
 * Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
 * Keep Pull Requests small and easily reviewable.  https://www.thedroidsonroids.com/blog/splitting-pull-request for
 a writeup of good practices.

docs/man-page/man_medley.html

@@ -20,9 +20,10 @@ invocation of medley.</p>
 <dd>
 <p>Prints out a brief summary of the flags and arguments to medley.</p>
 </dd>
-<dt>-z, --man</dt>
+<dt>-z [+], --man [+]</dt>
 <dd>
-<p>Show the man page for medley</p>
+<p>Show the man page for medley. If the <strong>+</strong> parameter is
+specified, then no pager is used when displaying the man page.</p>
 </dd>
 <dt>-c [<em>FILE</em> | -], --config [<em>FILE</em> | -]</dt>
 <dd>
@@ -101,7 +102,7 @@ virtual display.</p>
 <dt>-g [<em>WxH</em> | -], --geometry [<em>WxH</em> | -]</dt>
 <dd>
 <p>Sets the size of the X Window (or VNC window) that Medley runs in to
-be Width x Height. (Full X Windows geomtery specification with +X+Y is
+be Width x Height. (Full X Windows geometry specification with +X+Y is
 not currently supported).</p>
 <p>If a value of “-” is given, geometry is set to the default value.</p>
 <p>If --geometry is not specified but --screensize is, then the window
@@ -293,6 +294,16 @@ that detects Xvnc server failures. Setting this flag notifies Medley
 that very short Medley sessions are possible and the Xvnc error
 detection needs to be adjusted accordingly.</p>
 </dd>
+<dt>-tg [<em>TAG</em> | -], --tag [<em>TAG</em> | -]</dt>
+<dd>
+<p>By default, sysout files are loaded from the MEDLEYDIR/loadups
+directory. If “--tag <em>TAG</em>” is specified, then by default sysout
+files are loaded from the MEDLEYDIR/loadups/tagged/TAG directory. The
+sysouts in these directories are created using a loadups script with the
+--tag flag set. See the loadup man page. If <em>TAG</em> is “-”, then
+the name of the active git branch for MEDLEYDIR (if any) is used as
+<em>TAG</em>.</p>
+</dd>
 </dl>
 <h2>Other Options</h2>
 <dl>

docs/man-page/medley.1

@@ -45,8 +45,10 @@ hence MEDLEYDIR is computed on each invocation of medley.
 -h, --help
 Prints out a brief summary of the flags and arguments to medley.
 .TP
--z, --man
-Show the man page for medley
+-z [+], --man [+]
+Show the man page for medley.
+If the \f[B]+\f[R] parameter is specified, then no pager is used when
+displaying the man page.
 .TP
 -c [\f[I]FILE\f[R] | -], --config [\f[I]FILE\f[R] | -]
 Use \f[I]FILE\f[R] as the config file for this run of Medley.
@@ -151,7 +153,7 @@ virtual display.
 -g [\f[I]WxH\f[R] | -], --geometry [\f[I]WxH\f[R] | -]
 Sets the size of the X Window (or VNC window) that Medley runs in to be
 Width x Height.
-(Full X Windows geomtery specification with +X+Y is not currently
+(Full X Windows geometry specification with +X+Y is not currently
 supported).
 .RS
 .PP
@@ -395,6 +397,17 @@ This can cause issues with medley code that detects Xvnc server
 failures.
 Setting this flag notifies Medley that very short Medley sessions are
 possible and the Xvnc error detection needs to be adjusted accordingly.
+.TP
+-tg [\f[I]TAG\f[R] | -], --tag [\f[I]TAG\f[R] | -]
+By default, sysout files are loaded from the MEDLEYDIR/loadups
+directory.
+If \[lq]--tag \f[I]TAG\f[R]\[rq] is specified, then by default sysout
+files are loaded from the MEDLEYDIR/loadups/tagged/TAG directory.
+The sysouts in these directories are created using a loadups script with
+the --tag flag set.
+See the loadup man page.
+If \f[I]TAG\f[R] is \[lq]-\[rq], then the name of the active git branch
+for MEDLEYDIR (if any) is used as \f[I]TAG\f[R].
 .SS Other Options
 .PP
 \ 

docs/man-page/medley.1.md

@@ -38,8 +38,9 @@ Flags
 -h, \-\-help
 : Prints out a brief summary of the flags and arguments to medley.
 
--z, \-\-man
-: Show the man page for medley
+-z [+], \-\-man [+]
+: Show the man page for medley. If the **+** parameter is specified, then no pager is used when
+displaying the man page.
 
 -c [*FILE* | -], \-\-config [*FILE* | -]
 : Use *FILE* as the config file for this run of Medley. See information on *CONFIG FILE* below.
@@ -106,7 +107,7 @@ than the window, there will be no way to pan to the non-visible parts of the vir
 
 -g [*WxH* | -], \-\-geometry [*WxH* | -]
 : Sets the size of the X Window (or VNC window) that Medley runs in to be Width x Height. (Full X Windows
-geomtery specification with +X+Y is not currently supported).
+geometry specification with +X+Y is not currently supported).
 
     If a value of "-" is given, geometry is set to the default value.
 
@@ -263,6 +264,14 @@ specified in the Medley file system, not the host Windows file system.
 will run for a very short time (< a couple of seconds).  This can cause issues with medley code that detects Xvnc server failures.
 Setting this flag notifies Medley that very short Medley sessions are possible and the Xvnc error detection needs to be adjusted accordingly.
 
+-tg [*TAG* | -], \-\-tag [*TAG* | -]
+: By default, sysout files are loaded from the MEDLEYDIR/loadups directory.
+If "\-\-tag *TAG*" is specified, then by default sysout files are loaded from the
+MEDLEYDIR/loadups/tagged/TAG directory.  The sysouts in these directories are created using
+a loadups script with the \-\-tag flag set.  See the loadup man page.
+If *TAG* is "-", then the name of the active git branch for MEDLEYDIR (if any) is used as
+*TAG*. 
+
 
 Other Options
 -------------

fonts/adobe/DISPLAYFONTCOERCIONS

@@ -1 +0,0 @@
-(DEFINE-FILE-INFO READTABLE "XCL" PACKAGE "INTERLISP")