wm: doc

--- a/date.ms

+++ b/date.ms

@@ -1,9 +1,20 @@

-# Date

+.HTML

+Date and time

+.TL

+Date and time

+.AU

+jrmu

+.AB

+Tips and tricks related to time and date in Plan 9

+.AE

 To change the timezone (takes effect upon reboot):

+.P1

 ; cp /adm/timezone/$yourzone /adm/timezone/local

+.P2

+Note that Plan 9 timezone files are a bit outdated. but shouldn't be much issue in almost all cases.

+.LP

 To sync your clock:

-; aux/timesync -n pool.ntp.org

\ No newline at end of file

+.P1

+; aux/timesync -n pool.ntp.org

+.P2

--- a/dns.ms

+++ b/dns.ms

@@ -1,8 +1,10 @@

+.LP

 DNS errors may occur:

+.P1

 dns: file does not exist: /fd/0:3: < can't open: $user: '$user' directory entry not found

 /fd/0:4: /net/net/clone: '/net/net/clone' dns: file does not exist

+.P2

 This may mean either cs or ndb is dead. Both can be restarted with:

-; ndb/cs; kill dns | rc; ndb/dns

\ No newline at end of file

+.P1

+; ndb/cs; kill dns | rc; ndb/dns

+.P2

--- a/pi.ms

+++ b/pi.ms

@@ -66,6 +66,15 @@

 source code for wireless driver is available in

 .CW /sys/src/9/bcm/ether4330.c

.NH

+USB

+.LP

+It's widely believe before raspberry pi 4 (that includes zero 2), they had nasty USB controllers,

+while they may (is there a case otherwise?) work well for keyboard, mouses and thumb drives,

+they may not work as well as expected for devices that need more power.

+.LP

+Also note that, USB controller can crash (is it a hardware limit?) if it gets too hot,

+using a heat sink and fan is recommended if you are you are going to use that raspberry pi's USB (which sadly, also includes ethernet, since it uses USB).

+.NH

 UART

.NH

 Compiling a kernel

--- a/ramfs.ms

+++ b/ramfs.ms

@@ -1,3 +1,17 @@

+.HTML Memory file system

+.TL

+Memory file system

+.NH

+General notes

+.LP

+While ramfs is pretty fast, it's not optimal since it's single threaded.

+By default it has a maximum size limit of 768MB, if you need more,

+pass

+.CW -p

+flag.

+It also can end up filling your memory very quickly. be careful.

+.NH

+using ramfs instead of /tmp by default

.LP

 To use ramfs by default for /tmp,

 replace these two lines in $home/lib/profile:

--- a/shell.ms

+++ b/shell.ms

@@ -1,9 +1,8 @@

-# Shell

-To create a new user:

+.TL

+Shell

+.LP

+To create a new user:

+.P1

     con -C /srv/cwfs.cmd # this connects your cwfs console

     newuser $username # makes the account

     newuser upas +$username # adds to upas group, allows user to have an local mailbox

@@ -15,4 +14,5 @@

     assign new Inferno/POP secret? [y/n]: y

     make it the same as Plan 9 password? [y/n]: y

     # rest is easy, better to fill the email and sposoner email address (some programs need them)

-    auth/enable $username

\ No newline at end of file

+    auth/enable $username

+.P2

--- a/ssh.ms

+++ /dev/null

@@ -1,7 +1,0 @@

-# Ssh

-This will have nice large fonts:

-    ; vt -rxbf /lib/font/lucidasans/typeunicode.16.font ssh username@domain.com

\ No newline at end of file

--- /dev/null

+++ b/vt.ms

@@ -1,0 +1,49 @@

+.HTML Terminal emulator

+.TL

+Terminal emulator

+.LP

+.CW vt(1)

+is

+.I the

+terminal emulator for Plan 9,

+it's main use case is for programs such as

+.CW telnet(1)

+and

+.CW ssh(1)

+where they usually expect a form of terminal emulator existing.

+.B "You don't need vt to run plan 9 programs!"

+.NH

+connecting to unix systems

+.LP

+The argument

+.CW -r

+sets

+.CW vt(1)

+in

+.I "raw mode" ,

+which is required by most, if not all programs of UNIX.

+Raw mode allows the program handle details of screen and keyboard shortcuts (such as, ctrl-a or tab for example)

+instead of the terminal.

+You may also set the emulated terminal type using

+.CW -a ,

+.CW -2

+and

+.CW -x

+which set the emulated terminal to ASCII, VT220 and XTerm respectively.

+by default VT100 is emulated, which have no colors, use XTerm if you want colors.

+Default background color is white (what else?), but if you enjoy black,

+pass

+.CW -b

+.NH

+fonts

+.LP

+Like all plan 9 programs,

+.CW vt(1)

+too uses bitmap fonts, you may set it with

+.CW -f

+argument.

+for example, for

+.I "nice large fonts" :

+.P1

+; vt -rxbf /lib/font/lucidasans/typeunicode.16.font ssh username@domain.com

+.P2