wm: doc

Download patch

ref: 2447afe2b4d3641999104350be3676a2bc8755f0
parent: a02ecaf71ac7ccd9ce3c903b9c8e23d9558a5102
author: mkf <mkf@cloud9p.org>
date: Thu Sep 26 05:26:26 EDT 2024

remove all inline html

--- a/9.ms
+++ b/9.ms
@@ -1,5 +1,5 @@
-.TL 9
-.HTML 9
+.TL
+9
 
 .PP
 in 1970 UNIX was created as a small version of multiics on PDP-11 asm
@@ -101,4 +101,3 @@
 httpd will never know what is really on /secret-data, it just will see
 whatever is on empty/ all other procs (besides httpd forks), will see
 /secret-data as is.
-
--- a/9gridchan.ms
+++ b/9gridchan.ms
@@ -1,5 +1,5 @@
-.TL 9gridchan
-.HTML 9gridchan
+.TL
+9gridchan
 
 .SH
 From Plan9
@@ -41,4 +41,3 @@
 .IP [1]
 https://9fans.github.io/plan9port/
 .FE
-
--- a/9pideas.ms
+++ b/9pideas.ms
@@ -1,5 +1,5 @@
-.TL 9pideas
-.HTML 9pideas
+.TL 
+9pideas
 
 .PP
 troff->html,troffdown->markdown, postscript thing->web layout engine, 9p->http
--- a/acmemail.ms
+++ b/acmemail.ms
@@ -1,4 +1,3 @@
-.HTML "Acme Mmail"
 .TL
 Acme Mail
 .AU
@@ -14,17 +13,17 @@
 To read/send email on Plan 9: 
 .LP
 See
-.ihtml acmemail <a href="http://man.9front.org/1/acmemail">
+.LN http://man.9front.org/1/acmemail
 .I acmemail (1)
-.ihtml acmemail
+.LN
 ,
-.ihtml plumber <a href="http://man.9front.org/4/plumber">
+.LN http://man.9front.org/4/plumber
 .I plumber (4)
-.ihtml plumber
+.LN
 , and
-.ihtml upasfs <a href="http://man.9front.org/4/upasfs">
+.LN http://man.9front.org/4/upasfs
 .I upasfs (4)
-.ihtml upasfs
+.LN
 .P1
 ; plumber ; upas/fs ; acme 
 .P2
@@ -38,4 +37,4 @@
 ; rimport $server /sys/
 ; plumber; upas/fs; acme
 .P2
-Remember to replace cloud9p.org with your actual server.
\ No newline at end of file
+Remember to replace cloud9p.org with your actual server.
--- a/audio.ms
+++ b/audio.ms
@@ -1,5 +1,5 @@
-.HTML Audio
-.TL Audio
+.TL
+Audio
 
 .PP
 If the sound card is detected: 
--- a/backups.ms
+++ b/backups.ms
@@ -1,4 +1,3 @@
-.HTML "Backups"
 .TL
 Backups
 
--- a/date.ms
+++ b/date.ms
@@ -1,5 +1,3 @@
-.HTML
-Date and time
 .TL
 Date and time
 .AU
--- a/go.ms
+++ b/go.ms
@@ -1,4 +1,3 @@
-.HTML Installing Go on 9
 .TL 
 Installing Go on Plan 9
 .SH 
--- a/ideas.ms
+++ b/ideas.ms
@@ -1,5 +1,4 @@
 .TL Ideas
-.HTML Ideas
 
 .SH
 Fork of 9Front
@@ -91,4 +90,3 @@
 .FS
 [1]: https://pirata.dev/delphinusdnsd/
 .FE
-
--- a/install.ms
+++ b/install.ms
@@ -4,10 +4,9 @@
 jrmu (jrmu@cloud9p.org)
 .AB
 This guide explains how to install 9front as a virtual machine inside 
-.ihtml a <a href="https://wiki.ircnow.org/?n=Vmm.Intro">
-OpenBSD's vmm
-.ihtml a
-.
+.LN https://wiki.ircnow.org/Vmm.Intro
+OpenBSD's VMM
+.LN
 .AE
 
 .ihtml img <img src="https://wiki.ircnow.org/uploads/9/plan9-desktop.png">
@@ -17,13 +16,12 @@
 Download the ISO
 .LP
 This installation assumes you (or your admin) has
-.ihtml a <a href="https://wiki.ircnow.org/?n=Vmm.Configure">
-configured vmm
-.ihtml a
+.LN https://wiki.ircnow.org/Vmm.Intro
+configured VMM
+.LN
 properly.
 
 Inside your home folder, download the 9front ISO: 
-
 .P1
 $ ftp https://9front.org/iso/9front-10522.amd64.iso.gz
 $ sha256 9front-10522.amd64.iso.gz
--- a/jsdrawterm.ms
+++ b/jsdrawterm.ms
@@ -1,5 +1,5 @@
-.TL JSDrawterm
-.HTML JSDrawterm
+.TL
+JSDrawterm
 
 .PP
 Drawterm for your web browser. [1]
--- a/links.ms
+++ b/links.ms
@@ -19,4 +19,4 @@
 17. <https://github.com/henesy/awesome-plan9> 
 18. <https://franjballest.wordpress.com/books-papers/> 
 19. <http://helpful.cat-v.org> 
-20. <http://mirtchovski.postnix.pw/p9/>
\ No newline at end of file
+20. <http://mirtchovski.postnix.pw/p9/>
--- a/netcat.ms
+++ b/netcat.ms
@@ -12,13 +12,13 @@
 trampoline(8)
 .LP
 One substitute for
-.HTML <a href="https://wiki.ircnow.org/?n=Netcat.Usage">
+.LN https://wiki.ircnow.org/?n=Netcat.Usage
 netcat
-.HTML </a>
+.LN
 is 
-.HTML <a href="http://man.9front.org/8/trampoline">
+.LN http://man.9front.org/8/trampoline
 trampoline(8)
-.HTML </a>
+.LN
 .
 
 .P1
@@ -37,7 +37,6 @@
 For example, to connect in plaintext to the IRC server
 .CW irc.ircnow.org
 on port 6667:
-
 .P1
 ; aux/trampoline tcp!irc.ircnow.org!6667
 .P2
@@ -46,9 +45,9 @@
 telnet(1)
 .LP
 Another substitute is
-.HTML <a href="http://man.9front.org/1/con">
+.LN http://man.9front.org/1/con
 telnet(1)
-.HTML </a>
+.LN
 .
 
 To create a
@@ -70,4 +69,4 @@
 .P2
 
 .PP
-To connect to a webserver, use 
 (carriage return C-m).
\ No newline at end of file
+To connect to a webserver, use 
 (carriage return C-m).
--- a/pi.ms
+++ b/pi.ms
@@ -1,4 +1,3 @@
-.HTML "plan 9 on pi"
 .TL
 plan 9 on pi
 
@@ -136,9 +135,9 @@
 .CW hdmi_mode
 are used to set type of display (TV or monitor) and resolution of such.
 see
-.ihtml a <a href="https://www.raspberrypi.com/documentation/computers/legacy_config_txt.html#hdmi-mode">
-.CW https://www.raspberrypi.com/documentation/computers/legacy_config_txt.html#hdmi-mode
-.ihtml a
+.LN https://www.raspberrypi.com/documentation/computers/legacy_config_txt.html#hdmi-mode
+raspberry pi documention
+.LN
 for more info on those.
 Lastly
 .CW framebuffer_depth
--- a/ramfs.ms
+++ b/ramfs.ms
@@ -1,4 +1,3 @@
-.HTML Memory file system
 .TL
 Memory file system
 .NH
--- a/reading.ms
+++ b/reading.ms
@@ -1,5 +1,5 @@
-.TL Reading
-.HTML Reading
+.TL
+Reading
 
 .IP 1. 4
 The RISC-V Reader: An Open Architecture Atlas 
@@ -27,5 +27,3 @@
 Published by Morgan Kaufmann, 2017 
 .IP * 8
 ISBN 10: 0128122757ISBN 13: 9780128122754
-
-
--- a/splinternet.ms
+++ b/splinternet.ms
@@ -1,5 +1,5 @@
-.TL The Net is Dead, Long Live Inter9
-.HTML The Net is Dead, Long Live Inter9
+.TL
+The Net is Dead, Long Live Inter9
 
 .SH
 The Internet is fundamentally broken: 
@@ -94,4 +94,3 @@
 .PP
 There is a race now to create a new, free and open internet. Our network should
 aim to be the first to create one with the right pinciples.
-
--- a/sysupdate.ms
+++ b/sysupdate.ms
@@ -1,5 +1,5 @@
-.TL Sysupdate
-.HTML Sysupdate
+.TL
+Sysupdate
 
 .SH
 To update your system: 
@@ -24,4 +24,3 @@
 .P1
 ; cd /sys/src/9/pc64 ; mk install
 .P2
-
--- a/template.ms
+++ b/template.ms
@@ -1,4 +1,3 @@
-.HTML "template"
 .TL
 template
 
@@ -12,4 +11,7 @@
 .AE
 
 .LP
-here is an paragraph.
\ No newline at end of file
+here is an paragraph.
+.LN template.html
+this is a hypelink, you can click on it in browsers.
+.LN
\ No newline at end of file
--- a/theming.ms
+++ b/theming.ms
@@ -1,5 +1,4 @@
-.HTML Theming Rio and acme
-.TL 
+.TL
 Theming Rio and acme
 
 .SH
@@ -7,10 +6,10 @@
 .PP
 Install Sigrid's Rio theming patch: 
 .P1
-bind -ac /dist/plan9front /
-cd /sys/src/cmd/rio
-hget https://ftrv.se/_/9/patches/rio-themes.patch | patch -p5
-mk install
+; bind -ac /dist/plan9front /
+; cd /sys/src/cmd/rio
+; hget https://ftrv.se/_/9/patches/rio-themes.patch | patch -p5
+; mk install
 .P2
 
 Themes can be installed by writing to the /mnt/wsys/theme file while a patched rio install is running. 
--- a/troff.ms
+++ b/troff.ms
@@ -1,4 +1,3 @@
-.HTML "Troff quickstart"
 .TL
 Troff quickstart
 
@@ -18,10 +17,19 @@
 titleless documents are possible, however better to be avoided.
 .CW ms
 macros offer the 
-.CW .LP  
+.CW .TL  
 macro, to name the title of document.
-HTML documents also need another macro for their
-.CW <title>
-tag, use .HTML to mention title of html version of document.
- 
-.PP
+for hyperlinks (in html), you may use
+.CW .LN
+macro, in the following form:
+.P1
+.LN link
+your text
+.LN
+.P2
+for example:
+.P1
+.LN https://cloud9p.org
+cloud9p site
+.LN
+.P2
--- a/userguide.ms
+++ b/userguide.ms
@@ -1,4 +1,3 @@
-.HTML Welcome to Plan 9
 .TL
 Welcome to Plan 9
 .AB
--- a/vmm.ms
+++ b/vmm.ms
@@ -4,10 +4,9 @@
 jrmu (jrmu@cloud9p.org)
 .AB
 This guide explains how to install 9front as a virtual machine inside 
-.ihtml a <a href="https://wiki.ircnow.org/?n=Vmm.Intro">
+.LN https://wiki.ircnow.org/Vmm.Intro
 OpenBSD's vmm
-.ihtml a
-.
+.LN
 .AE
 
 .SH
@@ -17,9 +16,9 @@
 .ihtml img
 
 This installation assumes you have
-.ihtml a <a href="vmm.html">
+.LN vmm.html
 configured vmm
-.ihtml a
+.LN
 properly.
 
 Download the 9front ISO: 
@@ -62,4 +61,4 @@
 
 $ doas vmctl reload
 $ vmctl start -c $USER
-host# vmctl start -c jrmu
\ No newline at end of file
+
--- a/vt.ms
+++ b/vt.ms
@@ -1,4 +1,3 @@
-.HTML Terminal emulator
 .TL
 Terminal emulator
 .LP
--- a/why9.ms
+++ b/why9.ms
@@ -1,4 +1,3 @@
-.HTML "Why Plan 9"
 .TL
 Why Plan 9
 .AU
@@ -16,13 +15,13 @@
 .AE
 .LP
 Today's Linux/BSD systems are heavily controlled by corporate interests. It is unlikely that these corporations will tolerate 
-.HTML <a href="./inter9.html">
+.LN ./inter9.html
 the Inter9's
-.HTML </a>
+.LN
  efforts to preserve user freedom on the Internet. Moreover,
-.HTML <a href="./inter9.html">
+.LN ./inter9.html
 the Inter9's
-.HTML </a>
+.LN
  users will be unable to make any significant impact or contribution to existing projects. A new project is needed which is specifically chosen for the task of connecting together isolated networks.
 .PP
 In general, OpenBSD's goals do not match the Inter9's. OpenBSD's community is insular; it is not particularly friendly towards, nor interested in, outreach to newbies. It is unlikely that newbie contributions would get integrated into upstream. It may not accept the Inter9's goals of improving network equality and freedom. 
@@ -29,29 +28,29 @@
 .PP
 OpenBSD now receives the majority of its funding from large corporate contributors.
 .FS
-.HTML <a href="https://www.openbsdfoundation.org/contributors.html">
+.LN https://www.openbsdfoundation.org/contributors.html
 OpenBSD Foundation Contributors
-.HTML </a>
+.LN
 .FE
 As of 2022, its top donors include Google, Meta, and Microsoft. And unfortunately, it too is heavily dependent on Linux's corporate ecosystem. For example, efforts have been made to add wayland support.
 .FS
-.HTML <a href="https://xenocara.org/Wayland_on_OpenBSD.html">
+.LN https://xenocara.org/Wayland_on_OpenBSD.html
 Wayland on OpenBSD
-.HTML </a>
+.LN
 .FE
 Most Linux distros today suffer from the second system effect. Components such as Wayland and systemd are becoming too complex for average users to understand and contribute to. These are not merely technical concerns: many of these software projects have vowed hostility towards user freedom. Wayland is dangerous because its parent organization, X.org Foundation, has called for a total boycott of the Free Software Foundation.
 .FS
 X.org is signatory #61 in the
-.HTML <a href="https://rms-open-letter.github.io/"
+.LN https://rms-open-letter.github.io/
 RMS boycott petition
-.HTML </a>
+.LN
 .FE
 .LP
  Red Hat in particular has called for a complete boycott of the FSF.
 .FS
-.HTML <a href="https://www.redhat.com/en/blog/red-hat-statement-about-richard-stallmans-return-free-software-foundation-board">
+.LN https://www.redhat.com/en/blog/red-hat-statement-about-richard-stallmans-return-free-software-foundation-board
 Red Hat statement about Richard Stallman's return to the FSF
-.HTML </a>
+.LN
 .FE
 .PP
 If Wayland and systemd succeed, they will make it difficult to maintain independent UNIX systems (OpenBSD included) that are not dependent upon IBM Red Hat's ecosystem.
@@ -58,16 +57,16 @@
 .PP
 Besides corporate influence, political conflicts are likely to affect the Linux ecosystem. The Linux kernel itself is at risk of a potential fork in the kernel itself due to sanctions.
 .FS
-.HTML <a href="https://www.phoronix.com/news/Linux-STMAC-Russian-Sanctions">
+.LN https://www.phoronix.com/news/Linux-STMAC-Russian-Sanctions
 Linux Kernel Networking Driver Development Impacted By Russian Sanctions
-.HTML </a>
+.LN
 .FE
 .PP
 For these reasons, the Inter9 community needs to have its own, independent system that it can work on, specifically tailored to its goal of preserving democratic control of networks. An independent project will best ensure the Inter9 can achieve its goals of user control of the network. Because the Inter9 is independently developed, it can rely on funding from diverse sources to avoid the harmful influences of corporate control.
 .PP
-.HTML <a href="http://9p.io/plan9">
+.LN http://9p.io/plan9
 Plan 9
-.HTML </a>
+.LN
  provides an elegant, easy-to-learn, and highly effective development environment for connecting together disparate networks. Its small size (10 to 100x smaller than most Unix-like distributions) makes it easy to understand and easy to modify the code. By design, Plan 9 is a
 .I distributed
 operating system that offers
@@ -83,9 +82,9 @@
 A few principles will be adopted. First, all users will be welcome, including novices. Secondly, users will be treated as co-developers. Every user will be encouraged to code, and all contributions encouraged. The Inter9 will follow the bazaar model of development. 
 .FS
 See Eric S. Raymond's
-.HTML <a href="https://www.catb.org/~esr/writings/cathedral-bazaar/">
+.LN https://www.catb.org/~esr/writings/cathedral-bazaar/
 Cathedral and the Bazaar
-.HTML </a>
+.LN
 .FE
 .PP
 New code for Plan 9 can be written in both C and Lua. Lua provides a minimalist, high-level language that does not suffer from heavy corporate influence. It will allow rapid software development and provides a good alternative to python, javascript, rust, and go. Use of Lua is encouraged. 
@@ -92,4 +91,4 @@
 .PP
 At first, the method to popularize Plan 9 is to install it inside existing operating systems like Linux and BSD. This will allow users to run 9 applications while still retaining their existing software. This will allow Plan 9 to immediately support all existing hardware. 
 .PP
-Plan 9 offers many alternatives for corporate components used by Linux. For example, rio presents a much simpler and more elegant alternative to Wayland. Rio's interface also presents a lower learning curve than terminal user interface (TUI) applications. acme is a powerful text editor that fits the Unix philosophy. It effectively replaces applications like vi and emacs that still rely on obsolete teletype computing models. This makes it easier for new developers to learn to program for Plan 9. Writing GUIs for unix-like windowing toolkits is usually very complex, but rio makes it very simple. Unlike Wayland, Rio offers network transparency today. It is ready to use with mice, trackpads, and touchscreens. Its code base is far smaller. It provides a good alternative to the obsolete X Windowing system.
\ No newline at end of file
+Plan 9 offers many alternatives for corporate components used by Linux. For example, rio presents a much simpler and more elegant alternative to Wayland. Rio's interface also presents a lower learning curve than terminal user interface (TUI) applications. acme is a powerful text editor that fits the Unix philosophy. It effectively replaces applications like vi and emacs that still rely on obsolete teletype computing models. This makes it easier for new developers to learn to program for Plan 9. Writing GUIs for unix-like windowing toolkits is usually very complex, but rio makes it very simple. Unlike Wayland, Rio offers network transparency today. It is ready to use with mice, trackpads, and touchscreens. Its code base is far smaller. It provides a good alternative to the obsolete X Windowing system.