Update the Kermit 95 User Manual for v3.0 #294
Draft
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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.
And the description of them
Only remaining ones are internal links within ckermi70.html and ckermi80.html which we aren't currently using.
These are now fixed.
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.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.