Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update the Kermit 95 User Manual for v3.0 #294

Draft
wants to merge 174 commits into
base: master
Choose a base branch
from
Draft

Update the Kermit 95 User Manual for v3.0 #294

wants to merge 174 commits into from

Conversation

davidrg
Copy link
Owner

@davidrg davidrg commented Aug 22, 2024

No description provided.

davidrg added 30 commits July 24, 2024 17:21
with permission from Frank.

Changes from what was on the CD-ROM:
* kermit95.html has been renamed to index.html
* k95faq.html is gone
* All file extensions have been changed from .htm to .html
* Some minor changes to the front matter in the main page
* Perhaps some other minor content changes around the place.
Some of these are bits that weren't updated for the release of K95G, plus a few broken links fixed
Some of these never applied to K95G
Bug 794 was duplicated - the second bug with that number has been renumbered as 819
These (should) all exist in K95 2.1.3, most are fixed in K95 v3.0.

Also updated various URIs at the top of the page.
It runs pretty slowly, but it only requires Kermit 95 and optionally git
I don't think it makes sense to keep tracking editions of the manual anymore - ideally it would be updated for each release of K95 that has anything more than bug fixes, so the edition number would go up with most K95 releases. Having the actual K95 version number in the manual should be enough to differentiate different versions of the manual.
This isn't being developed under Columbia anymore. Also mention the C-Kermit 9 supplement.
K95 2.0 was over 20 years ago - reword to put the GUI version further in the past
And even when we do have one, it won't be mandatory
Move some of the command line argument discussion to cmdline.html, and leave the rest out for now. Its probably worthwhile revising cmdline.html to document more than just the K95-specific options but thats a job for another day
To MS-DOS Kermit, C-Kermit and their documentation
And add an ISO8601-style date replacement tag too
Add links to the github issue tracker, github discussions, and the kermit usenet newsgroup (not that it is really active now)
As we don't have any of those at the moment (though it might be nice to add some - see ticket #292).

Also commented out the section about the preloaded Columbia IKS service entry as that doesn't exist anymore.
It doesn't exist anymore
rather than the old ckwin.htm
And disable special win95 fixes, just to see if the x64 build and/or win95 fixes were having trouble on github
Its faster and cleaner. Also get rid of the dry-run option - its not useful.
It ends up reading EOF which terminates the process (after producing a lot of errors due to REXX still running)
This is to allow documentation for unreleased versions of Kermit 95 to be published online with a warning that it is subject to change. An example banner can be found in preliminary.html
This means that mkdocs.ksc (and the two .rex files) can do the full job and mkdocs.bat is just a convenience thing to make the command line arguments a bit easier.
commit 4bdcf3c
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 16:58:18 2025 +1300

    Update build.yml

commit d3be0ef
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 16:46:59 2025 +1300

    Update build.yml

commit 23016c5
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 15:52:14 2025 +1300

    Update build.yml

commit 4f3df07
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 15:05:48 2025 +1300

    Update action.yml

commit 59bc300
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 15:01:59 2025 +1300

    Fetch win32 unzip

commit 34e0b7a
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 14:33:13 2025 +1300

    Update build.yml

commit be466b7
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 14:23:27 2025 +1300

    Update build.yml

commit 4ac5aa2
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 14:04:42 2025 +1300

    Update build.yml

commit 86359b9
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 13:57:37 2025 +1300

    Update build.yml

commit 0a5c6f0
Author: David Goodwin <[email protected]>
Date:   Sat Jan 18 13:45:48 2025 +1300

    Prepare to update K2 artifacts
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update the K95 manual for version 3.0
1 participant