Hex Artifact Content
Not logged in

Artifact fa58861fa76aded6438677be388a3fd9ce6435b1:

File www/wikitheory.wiki part of check-in [7083eb1a1c] - Change the markup in the index.wiki page from HTML to wiki. Extend the wikitheory.wiki page. Other documentation tweaks. by drh on 2008-11-20 03:14:22.

0000: 3c 68 31 3e 57 69 6b 69 20 49 6e 20 5b 2e 2f 69  <h1>Wiki In [./i
0010: 6e 64 65 78 2e 77 69 6b 69 20 20 7c 20 46 6f 73  ndex.wiki  | Fos
0020: 73 69 6c 5d 3c 2f 68 31 3e 0a 0a 46 6f 73 73 69  sil]</h1>..Fossi
0030: 6c 20 75 73 65 73 20 5b 2f 77 69 6b 69 5f 72 75  l uses [/wiki_ru
0040: 6c 65 73 20 7c 20 77 69 6b 69 20 6d 61 72 6b 75  les | wiki marku
0050: 70 5d 20 66 6f 72 20 6d 61 6e 79 20 74 68 69 6e  p] for many thin
0060: 67 73 3a 0a 0a 20 20 20 2a 20 20 53 74 61 6e 64  gs:..   *  Stand
0070: 2d 61 6c 6f 6e 65 20 77 69 6b 69 20 70 61 67 65  -alone wiki page
0080: 73 2e 0a 20 20 20 2a 20 20 44 65 73 63 72 69 70  s..   *  Descrip
0090: 74 69 6f 6e 20 61 6e 64 20 63 6f 6d 6d 65 6e 74  tion and comment
00a0: 73 20 69 6e 20 5b 2e 2f 62 75 67 74 68 65 6f 72  s in [./bugtheor
00b0: 79 2e 77 69 6b 69 20 7c 20 62 75 67 20 72 65 70  y.wiki | bug rep
00c0: 6f 72 74 73 5d 2e 0a 20 20 20 2a 20 20 43 68 65  orts]..   *  Che
00d0: 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 2e 0a  ck-in comments..
00e0: 20 20 20 2a 20 20 5b 2e 2f 65 6d 62 65 64 64 65     *  [./embedde
00f0: 64 64 6f 63 2e 77 69 6b 69 20 7c 20 45 6d 62 65  ddoc.wiki | Embe
0100: 64 64 65 64 20 64 6f 63 75 6d 65 6e 74 61 74 69  dded documentati
0110: 6f 6e 5d 20 66 69 6c 65 73 20 77 68 6f 73 65 0a  on] files whose.
0120: 20 20 20 20 20 20 6e 61 6d 65 20 65 6e 64 73 20        name ends 
0130: 69 6e 20 22 77 69 6b 69 22 2e 0a 0a 54 68 65 20  in "wiki"...The 
0140: 5b 2f 77 69 6b 69 5f 72 75 6c 65 73 20 7c 20 66  [/wiki_rules | f
0150: 6f 72 6d 61 74 74 69 6e 67 20 72 75 6c 65 73 5d  ormatting rules]
0160: 20 66 6f 72 20 66 6f 73 73 69 6c 20 77 69 6b 69   for fossil wiki
0170: 0a 61 72 65 20 64 65 73 69 67 6e 65 64 20 74 6f  .are designed to
0180: 20 62 65 20 73 69 6d 70 6c 65 20 61 6e 64 20 69   be simple and i
0190: 6e 74 75 69 74 69 76 65 2e 20 20 54 68 65 20 69  ntuitive.  The i
01a0: 64 65 61 20 69 73 20 74 68 61 74 20 77 69 6b 69  dea is that wiki
01b0: 20 70 72 6f 76 69 64 65 73 0a 70 61 72 61 67 61   provides.paraga
01c0: 70 68 20 62 72 65 61 6b 73 2c 20 6e 75 6d 62 65  ph breaks, numbe
01d0: 72 65 64 20 61 6e 64 20 62 75 6c 6c 65 74 74 65  red and bullette
01e0: 64 20 6c 69 73 74 73 2c 20 61 6e 64 20 68 79 70  d lists, and hyp
01f0: 65 72 6c 69 6e 6b 69 6e 67 20 66 6f 72 0a 73 69  erlinking for.si
0200: 6d 70 6c 65 20 64 6f 63 75 6d 65 6e 74 73 20 74  mple documents t
0210: 6f 67 65 74 68 65 72 20 77 69 74 68 20 61 20 73  ogether with a s
0220: 61 66 65 20 73 75 62 73 65 74 20 6f 66 20 48 54  afe subset of HT
0230: 4d 4c 20 66 6f 72 20 6d 6f 72 65 20 63 6f 6d 70  ML for more comp
0240: 6c 65 78 0a 66 6f 72 6d 61 74 74 69 6e 67 20 74  lex.formatting t
0250: 61 73 6b 73 2e 0a 0a 53 6f 6d 65 20 63 6f 6d 6d  asks...Some comm
0260: 65 6e 74 61 74 6f 72 73 20 66 65 65 6c 20 74 68  entators feel th
0270: 61 74 20 74 68 65 20 75 73 65 20 6f 66 20 48 54  at the use of HT
0280: 4d 4c 20 69 73 20 61 20 6d 69 73 74 61 6b 65 20  ML is a mistake 
0290: 61 6e 64 20 74 68 61 74 0a 66 6f 73 73 69 6c 20  and that.fossil 
02a0: 73 68 6f 75 6c 64 20 75 73 65 20 74 68 65 20 6d  should use the m
02b0: 61 72 6b 75 70 20 6c 61 6e 67 75 61 67 65 20 6f  arkup language o
02c0: 66 20 74 68 65 0a 3c 69 3e 66 69 6c 6c 2d 69 6e  f the.<i>fill-in
02d0: 2d 79 6f 75 72 2d 66 61 76 6f 72 69 74 65 3c 2f  -your-favorite</
02e0: 69 3e 20 77 69 6b 69 20 65 6e 67 69 6e 65 20 69  i> wiki engine i
02f0: 6e 73 74 65 61 64 2e 20 20 54 68 61 74 20 61 70  nstead.  That ap
0300: 70 72 6f 61 63 68 0a 77 61 73 20 63 6f 6e 73 69  proach.was consi
0310: 64 65 72 65 64 20 62 75 74 20 77 61 73 20 72 65  dered but was re
0320: 6a 65 63 74 65 64 20 66 6f 72 20 74 68 65 20 66  jected for the f
0330: 6f 6c 6c 6f 77 69 6e 67 20 72 65 61 73 6f 6e 73  ollowing reasons
0340: 3a 0a 0a 20 20 31 2e 20 20 54 68 65 72 65 20 69  :..  1.  There i
0350: 73 20 6e 6f 20 73 74 61 6e 64 61 72 64 20 77 69  s no standard wi
0360: 6b 69 20 6d 61 72 6b 75 70 20 6c 61 6e 67 75 61  ki markup langua
0370: 67 65 2e 20 20 45 76 65 72 79 20 77 69 6b 69 20  ge.  Every wiki 
0380: 65 6e 67 69 6e 65 20 64 6f 65 73 0a 20 20 20 20  engine does.    
0390: 20 20 69 74 20 61 20 6c 69 74 74 6c 65 20 64 69    it a little di
03a0: 66 66 65 72 65 6e 74 6c 79 2e 0a 0a 20 20 32 2e  fferently...  2.
03b0: 20 20 54 68 65 20 77 69 6b 69 20 6d 61 72 6b 75    The wiki marku
03c0: 70 20 75 73 65 64 20 62 79 20 66 6f 73 73 69 6c  p used by fossil
03d0: 2c 20 74 68 6f 75 67 68 20 6c 69 6d 69 74 65 64  , though limited
03e0: 2c 20 69 73 20 63 6f 6d 6d 6f 6e 20 74 6f 20 6d  , is common to m
03f0: 6f 73 74 0a 20 20 20 20 20 20 6f 74 68 65 72 20  ost.      other 
0400: 77 69 6b 69 20 65 6e 67 69 6e 65 73 2c 20 69 73  wiki engines, is
0410: 20 69 6e 74 75 69 74 69 76 65 2c 20 61 6e 64 20   intuitive, and 
0420: 69 73 20 73 75 66 66 69 63 69 65 6e 74 20 66 6f  is sufficient fo
0430: 72 20 39 30 25 20 6f 66 0a 20 20 20 20 20 20 61  r 90% of.      a
0440: 6c 6c 20 66 6f 72 6d 61 74 74 69 6e 67 20 74 61  ll formatting ta
0450: 73 6b 73 2e 0a 0a 20 20 33 2e 20 20 57 68 65 72  sks...  3.  Wher
0460: 65 20 74 68 65 20 66 6f 73 73 69 6c 20 77 69 6b  e the fossil wik
0470: 69 20 6d 61 72 6b 75 70 20 6c 61 6e 67 75 61 67  i markup languag
0480: 65 20 69 73 20 69 6e 73 75 66 66 69 63 69 65 6e  e is insufficien
0490: 74 2c 20 48 54 4d 4c 20 69 73 0a 20 20 20 20 20  t, HTML is.     
04a0: 20 75 73 65 64 2e 20 20 48 54 4d 4c 20 69 73 20   used.  HTML is 
04b0: 61 20 73 74 61 6e 64 61 72 64 20 6c 61 6e 67 75  a standard langu
04c0: 61 67 65 20 66 61 6d 69 6c 69 61 72 20 74 6f 20  age familiar to 
04d0: 6d 6f 73 74 20 70 72 6f 67 72 61 6d 6d 65 72 73  most programmers
04e0: 20 73 6f 0a 20 20 20 20 20 20 74 68 65 72 65 20   so.      there 
04f0: 69 73 20 6e 6f 74 68 69 6e 67 20 6e 65 77 20 74  is nothing new t
0500: 6f 20 6c 65 61 72 6e 2e 20 20 41 6e 64 2c 20 74  o learn.  And, t
0510: 68 6f 75 67 68 20 63 75 6d 62 65 72 73 6f 6d 65  hough cumbersome
0520: 2c 20 74 68 65 20 48 54 4d 4c 0a 20 20 20 20 20  , the HTML.     
0530: 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20 74   does not need t
0540: 6f 20 62 65 20 75 73 65 64 20 76 65 72 79 20 6f  o be used very o
0550: 66 74 65 6e 20 73 6f 20 6e 65 65 64 20 6e 6f 74  ften so need not
0560: 20 62 65 20 61 20 62 75 72 64 65 6e 2e 0a 0a 0a   be a burden....
0570: 3c 68 32 3e 53 74 61 6e 64 2d 61 6c 6f 6e 65 20  <h2>Stand-alone 
0580: 57 69 6b 69 20 50 61 67 65 73 3c 2f 68 32 3e 0a  Wiki Pages</h2>.
0590: 0a 45 61 63 68 20 77 69 6b 69 20 70 61 67 65 20  .Each wiki page 
05a0: 68 61 73 20 69 74 73 20 6f 77 6e 20 72 65 76 69  has its own revi
05b0: 73 69 6f 6e 20 68 69 73 74 6f 72 79 20 77 68 69  sion history whi
05c0: 63 68 20 69 73 20 69 6e 64 65 70 65 6e 64 65 6e  ch is independen
05d0: 74 20 6f 66 0a 74 68 65 20 73 65 71 75 65 6e 63  t of.the sequenc
05e0: 65 20 6f 66 20 62 61 73 65 6c 69 6e 65 73 20 28  e of baselines (
05f0: 63 68 65 63 6b 2d 69 6e 73 29 2e 20 20 57 69 6b  check-ins).  Wik
0600: 69 20 70 61 67 65 73 20 63 61 6e 20 62 72 61 6e  i pages can bran
0610: 63 68 20 61 6e 64 20 6d 65 72 67 65 0a 6a 75 73  ch and merge.jus
0620: 74 20 6c 69 6b 65 20 62 61 73 65 6c 69 6e 65 73  t like baselines
0630: 2c 20 74 68 6f 75 67 68 20 61 73 20 6f 66 20 74  , though as of t
0640: 68 69 73 20 77 72 69 74 69 6e 67 20 28 32 30 30  his writing (200
0650: 38 2d 30 37 2d 32 39 29 20 74 68 65 72 65 20 69  8-07-29) there i
0660: 73 0a 6e 6f 20 6d 65 63 68 61 6e 69 73 6d 20 69  s.no mechanism i
0670: 6e 20 74 68 65 20 75 73 65 72 20 69 6e 74 65 72  n the user inter
0680: 66 61 63 65 20 74 6f 20 73 75 70 70 6f 72 74 20  face to support 
0690: 62 72 61 6e 63 68 69 6e 67 20 61 6e 64 20 6d 65  branching and me
06a0: 72 67 69 6e 67 2e 0a 54 68 65 20 63 75 72 72 65  rging..The curre
06b0: 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  nt implementatio
06c0: 6e 20 6f 66 20 74 68 65 20 77 69 6b 69 20 73 68  n of the wiki sh
06d0: 6f 77 73 20 74 68 65 20 76 65 72 73 69 6f 6e 20  ows the version 
06e0: 6f 66 20 74 68 65 20 77 69 6b 69 0a 70 61 67 65  of the wiki.page
06f0: 20 74 68 61 74 20 68 61 73 20 74 68 65 20 6d 6f   that has the mo
0700: 73 74 20 72 65 63 65 6e 74 20 74 69 6d 65 73 74  st recent timest
0710: 61 6d 70 2e 0a 0a 49 6e 20 6f 74 68 65 72 20 77  amp...In other w
0720: 6f 72 64 73 2c 20 69 66 20 74 77 6f 20 75 73 65  ords, if two use
0730: 72 73 20 6d 61 6b 65 20 75 6e 72 65 6c 61 74 65  rs make unrelate
0740: 64 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65  d changes to the
0750: 20 73 61 6d 65 20 77 69 6b 69 0a 70 61 67 65 20   same wiki.page 
0760: 6f 6e 20 73 65 70 61 72 61 74 65 20 72 65 70 6f  on separate repo
0770: 73 69 74 6f 72 69 65 73 2c 20 74 68 65 6e 20 74  sitories, then t
0780: 68 6f 73 65 20 72 65 70 6f 73 69 74 6f 72 69 65  hose repositorie
0790: 73 20 61 72 65 20 73 79 6e 63 65 64 2c 0a 74 68  s are synced,.th
07a0: 65 20 77 69 6b 69 20 70 61 67 65 20 77 69 6c 6c  e wiki page will
07b0: 20 66 6f 72 6b 2e 20 20 54 68 65 20 77 65 62 20   fork.  The web 
07c0: 69 6e 74 65 72 66 61 63 65 20 77 69 6c 6c 20 64  interface will d
07d0: 69 73 70 6c 61 79 20 77 68 69 63 68 65 76 65 72  isplay whichever
07e0: 20 65 64 69 74 0a 77 61 73 20 63 68 65 63 6b 65   edit.was checke
07f0: 64 20 69 6e 20 6c 61 73 74 2e 20 20 54 68 65 20  d in last.  The 
0800: 6f 74 68 65 72 20 65 64 69 74 20 63 61 6e 20 62  other edit can b
0810: 65 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 68  e found in the h
0820: 69 73 74 6f 72 79 2e 20 20 54 68 65 0a 66 69 6c  istory.  The.fil
0830: 65 20 66 6f 72 6d 61 74 20 77 69 6c 6c 20 73 75  e format will su
0840: 70 70 6f 72 74 20 6d 65 72 67 69 6e 67 20 74 68  pport merging th
0850: 65 20 62 72 61 6e 63 68 65 73 20 62 61 63 6b 20  e branches back 
0860: 74 6f 67 65 74 68 65 72 2c 20 62 75 74 20 74 68  together, but th
0870: 65 72 65 0a 69 73 20 6e 6f 20 6d 65 63 68 61 6e  ere.is no mechan
0880: 69 73 6d 20 69 6e 20 74 68 65 20 75 73 65 72 20  ism in the user 
0890: 69 6e 74 65 72 66 61 63 65 20 28 79 65 74 29 20  interface (yet) 
08a0: 74 6f 20 70 65 72 66 6f 72 6d 20 74 68 65 20 6d  to perform the m
08b0: 65 72 67 65 2e 0a 0a 45 76 65 72 79 20 63 68 61  erge...Every cha
08c0: 6e 67 65 20 74 6f 20 61 20 77 69 6b 69 20 70 61  nge to a wiki pa
08d0: 67 65 20 69 73 20 61 20 73 65 70 61 72 61 74 65  ge is a separate
08e0: 20 0a 5b 2e 2f 66 69 6c 65 66 6f 72 6d 61 74 2e   .[./fileformat.
08f0: 77 69 6b 69 20 7c 20 63 6f 6e 74 72 6f 6c 20 61  wiki | control a
0900: 72 74 69 66 61 63 74 5d 0a 6f 66 20 74 79 70 65  rtifact].of type
0910: 20 5b 2e 2f 66 69 6c 65 66 6f 72 6d 61 74 2e 77   [./fileformat.w
0920: 69 6b 69 23 77 69 6b 69 63 68 6e 67 20 7c 20 22  iki#wikichng | "
0930: 57 69 6b 69 20 50 61 67 65 22 5d 2e 0a 0a 3c 68  Wiki Page"]...<h
0940: 32 3e 45 6d 62 65 64 64 65 64 20 44 6f 63 75 6d  2>Embedded Docum
0950: 65 6e 74 61 74 69 6f 6e 3c 2f 68 32 3e 0a 0a 46  entation</h2>..F
0960: 69 6c 65 73 20 69 6e 20 74 68 65 20 73 6f 75 72  iles in the sour
0970: 63 65 20 74 72 65 65 20 74 68 61 74 20 75 73 65  ce tree that use
0980: 20 74 68 65 20 22 2e 77 69 6b 69 22 20 73 75 66   the ".wiki" suf
0990: 66 69 78 20 63 61 6e 20 62 65 20 61 63 63 65 73  fix can be acces
09a0: 73 65 64 0a 61 6e 64 20 64 69 73 70 6c 61 79 65  sed.and displaye
09b0: 64 20 75 73 69 6e 67 20 73 70 65 63 69 61 6c 20  d using special 
09c0: 55 52 4c 73 20 74 6f 20 74 68 65 20 66 6f 73 73  URLs to the foss
09d0: 69 6c 20 73 65 72 76 65 72 2e 20 20 54 68 69 73  il server.  This
09e0: 20 61 6c 6c 6f 77 73 0a 70 72 6f 6a 65 63 74 20   allows.project 
09f0: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 74 6f  documentation to
0a00: 20 62 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68   be stored in th
0a10: 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 61 6e  e source tree an
0a20: 64 20 61 63 63 65 73 73 65 64 20 0a 6f 6e 6c 69  d accessed .onli
0a30: 6e 65 2e 20 20 28 44 65 74 61 69 6c 73 20 61 72  ne.  (Details ar
0a40: 65 20 64 65 73 63 72 69 70 74 65 64 20 5b 2e 2f  e descripted [./
0a50: 65 6d 62 65 64 64 65 64 64 6f 63 2e 77 69 6b 69  embeddeddoc.wiki
0a60: 20 7c 20 73 65 70 61 72 61 74 65 6c 79 5d 2e 29   | separately].)
0a70: 0a 0a 53 6f 6d 65 20 70 72 6f 6a 65 63 74 20 70  ..Some project p
0a80: 72 65 66 65 72 20 74 6f 20 73 74 6f 72 65 20 74  refer to store t
0a90: 68 65 69 72 20 64 6f 63 75 6d 65 6e 74 61 74 69  heir documentati
0aa0: 6f 6e 20 69 6e 20 77 69 6b 69 2e 20 20 54 68 65  on in wiki.  The
0ab0: 72 65 20 69 73 20 6e 6f 74 68 69 6e 67 0a 77 72  re is nothing.wr
0ac0: 6f 6e 67 20 77 69 74 68 20 74 68 61 74 2e 20 20  ong with that.  
0ad0: 42 75 74 20 6f 74 68 65 72 20 70 72 6f 6a 65 63  But other projec
0ae0: 74 73 20 70 72 65 66 65 72 20 74 6f 20 6b 65 65  ts prefer to kee
0af0: 70 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20  p documentation 
0b00: 61 73 20 70 61 72 74 0a 6f 66 20 74 68 65 20 73  as part.of the s
0b10: 6f 75 72 63 65 20 74 72 65 65 2c 20 73 6f 20 74  ource tree, so t
0b20: 68 61 74 20 69 74 20 69 73 20 76 65 72 73 69 6f  hat it is versio
0b30: 6e 65 64 20 61 6c 6f 6e 67 20 77 69 74 68 20 74  ned along with t
0b40: 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 61  he source tree a
0b50: 6e 64 0a 73 6f 20 74 68 61 74 20 6f 6e 6c 79 20  nd.so that only 
0b60: 64 65 76 65 6c 6f 70 65 72 73 20 77 69 74 68 20  developers with 
0b70: 63 68 65 63 6b 2d 69 6e 20 70 72 69 76 69 6c 65  check-in privile
0b80: 67 65 73 20 63 61 6e 20 63 68 61 6e 67 65 20 69  ges can change i
0b90: 74 2e 20 20 0a 45 6d 62 65 64 64 65 64 20 64 6f  t.  .Embedded do
0ba0: 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 65 72 76  cumentation serv
0bb0: 65 73 20 74 68 69 73 20 6c 61 74 74 65 72 20 70  es this latter p
0bc0: 75 72 70 6f 73 65 2e 20 20 42 6f 74 68 20 66 6f  urpose.  Both fo
0bd0: 72 6d 73 20 6f 66 20 64 6f 63 75 6d 65 6e 74 61  rms of documenta
0be0: 74 69 6f 6e 0a 75 73 65 20 74 68 65 20 65 78 61  tion.use the exa
0bf0: 63 74 20 73 61 6d 65 20 77 69 6b 69 20 6d 61 72  ct same wiki mar
0c00: 6b 75 70 20 6c 61 6e 67 75 61 67 65 2e 20 20 53  kup language.  S
0c10: 6f 6d 65 20 70 72 6f 6a 65 63 74 73 20 6d 61 79  ome projects may
0c20: 20 63 68 6f 6f 73 65 20 74 6f 0a 75 73 65 20 62   choose to.use b
0c30: 6f 74 68 20 66 6f 72 6d 73 20 6f 66 20 64 6f 63  oth forms of doc
0c40: 75 6d 65 6e 74 61 74 69 6f 6e 20 61 74 20 74 68  umentation at th
0c50: 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 0a 3c 68  e same time...<h
0c60: 32 3e 42 75 67 2d 72 65 70 6f 72 74 73 20 61 6e  2>Bug-reports an
0c70: 64 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65  d check-in comme
0c80: 6e 74 73 3c 2f 68 32 3e 0a 0a 54 68 65 20 63 6f  nts</h2>..The co
0c90: 6d 6d 65 6e 74 73 20 6f 6e 20 63 68 65 63 6b 2d  mments on check-
0ca0: 69 6e 73 20 61 6e 64 20 74 68 65 20 74 65 78 74  ins and the text
0cb0: 20 69 6e 20 74 68 65 20 64 65 73 63 72 69 70 74   in the descript
0cc0: 69 6f 6e 73 20 6f 66 20 62 75 67 20 72 65 70 6f  ions of bug repo
0cd0: 72 74 73 0a 62 6f 74 68 20 75 73 65 20 77 69 6b  rts.both use wik
0ce0: 69 20 66 6f 72 6d 61 74 74 69 6e 67 2e 20 20 45  i formatting.  E
0cf0: 78 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65 20  xactly the same 
0d00: 73 65 74 20 6f 66 20 66 6f 72 6d 61 74 74 69 6e  set of formattin
0d10: 67 20 72 75 6c 65 73 20 61 70 70 6c 79 2e 0a 54  g rules apply..T
0d20: 68 65 72 65 20 69 73 20 6e 65 76 65 72 20 61 20  here is never a 
0d30: 6e 65 65 64 20 74 6f 20 6c 65 61 72 6e 20 6f 6e  need to learn on
0d40: 65 20 66 6f 72 6d 61 74 74 69 6e 67 20 6c 61 6e  e formatting lan
0d50: 67 75 61 67 65 20 66 6f 72 20 64 6f 63 75 6d 65  guage for docume
0d60: 6e 74 61 74 69 6f 6e 0a 61 6e 64 20 61 20 64 69  ntation.and a di
0d70: 66 66 65 72 65 6e 74 20 6d 61 72 6b 75 70 20 66  fferent markup f
0d80: 6f 72 20 62 75 67 73 20 6f 72 20 66 6f 72 20 63  or bugs or for c
0d90: 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73  heck-in comments
0da0: 2e 0a                                            ..