Hex Artifact Content
Not logged in

Artifact 7cce5ff73627c7e28cbb38ba0abf5dc7aee674d1:

File www/wikitheory.wiki part of check-in [6ba52ae761] - Documentation tweaks. No changes to code. by drh on 2009-02-21 13:09:40.

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 69 73 20 6e 6f 74 20 61  ften so is not a
0560: 20 62 75 72 64 65 6e 2e 0a 0a 0a 3c 68 32 3e 53   burden....<h2>S
0570: 74 61 6e 64 2d 61 6c 6f 6e 65 20 57 69 6b 69 20  tand-alone Wiki 
0580: 50 61 67 65 73 3c 2f 68 32 3e 0a 0a 45 61 63 68  Pages</h2>..Each
0590: 20 77 69 6b 69 20 70 61 67 65 20 68 61 73 20 69   wiki page has i
05a0: 74 73 20 6f 77 6e 20 72 65 76 69 73 69 6f 6e 20  ts own revision 
05b0: 68 69 73 74 6f 72 79 20 77 68 69 63 68 20 69 73  history which is
05c0: 20 69 6e 64 65 70 65 6e 64 65 6e 74 20 6f 66 0a   independent of.
05d0: 74 68 65 20 73 65 71 75 65 6e 63 65 20 6f 66 20  the sequence of 
05e0: 63 68 65 63 6b 2d 69 6e 73 20 28 63 68 65 63 6b  check-ins (check
05f0: 2d 69 6e 73 29 2e 20 20 57 69 6b 69 20 70 61 67  -ins).  Wiki pag
0600: 65 73 20 63 61 6e 20 62 72 61 6e 63 68 20 61 6e  es can branch an
0610: 64 20 6d 65 72 67 65 0a 6a 75 73 74 20 6c 69 6b  d merge.just lik
0620: 65 20 63 68 65 63 6b 2d 69 6e 73 2c 20 74 68 6f  e check-ins, tho
0630: 75 67 68 20 61 73 20 6f 66 20 74 68 69 73 20 77  ugh as of this w
0640: 72 69 74 69 6e 67 20 28 32 30 30 38 2d 30 37 2d  riting (2008-07-
0650: 32 39 29 20 74 68 65 72 65 20 69 73 0a 6e 6f 20  29) there is.no 
0660: 6d 65 63 68 61 6e 69 73 6d 20 69 6e 20 74 68 65  mechanism in the
0670: 20 75 73 65 72 20 69 6e 74 65 72 66 61 63 65 20   user interface 
0680: 74 6f 20 73 75 70 70 6f 72 74 20 62 72 61 6e 63  to support branc
0690: 68 69 6e 67 20 61 6e 64 20 6d 65 72 67 69 6e 67  hing and merging
06a0: 2e 0a 54 68 65 20 63 75 72 72 65 6e 74 20 69 6d  ..The current im
06b0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20  plementation of 
06c0: 74 68 65 20 77 69 6b 69 20 73 68 6f 77 73 20 74  the wiki shows t
06d0: 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68  he version of th
06e0: 65 20 77 69 6b 69 0a 70 61 67 65 20 74 68 61 74  e wiki.page that
06f0: 20 68 61 73 20 74 68 65 20 6d 6f 73 74 20 72 65   has the most re
0700: 63 65 6e 74 20 74 69 6d 65 73 74 61 6d 70 2e 0a  cent timestamp..
0710: 0a 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c  .In other words,
0720: 20 69 66 20 74 77 6f 20 75 73 65 72 73 20 6d 61   if two users ma
0730: 6b 65 20 75 6e 72 65 6c 61 74 65 64 20 63 68 61  ke unrelated cha
0740: 6e 67 65 73 20 74 6f 20 74 68 65 20 73 61 6d 65  nges to the same
0750: 20 77 69 6b 69 0a 70 61 67 65 20 6f 6e 20 73 65   wiki.page on se
0760: 70 61 72 61 74 65 20 72 65 70 6f 73 69 74 6f 72  parate repositor
0770: 69 65 73 20 61 6e 64 20 74 68 6f 73 65 20 72 65  ies and those re
0780: 70 6f 73 69 74 6f 72 69 65 73 20 61 72 65 20 73  positories are s
0790: 79 6e 63 65 64 2c 0a 74 68 65 20 77 69 6b 69 20  ynced,.the wiki 
07a0: 70 61 67 65 20 77 69 6c 6c 20 66 6f 72 6b 2e 20  page will fork. 
07b0: 20 54 68 65 20 77 65 62 20 69 6e 74 65 72 66 61   The web interfa
07c0: 63 65 20 77 69 6c 6c 20 64 69 73 70 6c 61 79 20  ce will display 
07d0: 77 68 69 63 68 65 76 65 72 20 65 64 69 74 0a 77  whichever edit.w
07e0: 61 73 20 63 68 65 63 6b 65 64 20 69 6e 20 6c 61  as checked in la
07f0: 73 74 2e 20 20 54 68 65 20 6f 74 68 65 72 20 65  st.  The other e
0800: 64 69 74 20 63 61 6e 20 62 65 20 66 6f 75 6e 64  dit can be found
0810: 20 69 6e 20 74 68 65 20 68 69 73 74 6f 72 79 2e   in the history.
0820: 20 20 54 68 65 0a 66 69 6c 65 20 66 6f 72 6d 61    The.file forma
0830: 74 20 77 69 6c 6c 20 73 75 70 70 6f 72 74 20 6d  t will support m
0840: 65 72 67 69 6e 67 20 74 68 65 20 62 72 61 6e 63  erging the branc
0850: 68 65 73 20 62 61 63 6b 20 74 6f 67 65 74 68 65  hes back togethe
0860: 72 2c 20 62 75 74 20 74 68 65 72 65 0a 69 73 20  r, but there.is 
0870: 6e 6f 20 6d 65 63 68 61 6e 69 73 6d 20 69 6e 20  no mechanism in 
0880: 74 68 65 20 75 73 65 72 20 69 6e 74 65 72 66 61  the user interfa
0890: 63 65 20 28 79 65 74 29 20 74 6f 20 70 65 72 66  ce (yet) to perf
08a0: 6f 72 6d 20 74 68 65 20 6d 65 72 67 65 2e 0a 0a  orm the merge...
08b0: 45 76 65 72 79 20 63 68 61 6e 67 65 20 74 6f 20  Every change to 
08c0: 61 20 77 69 6b 69 20 70 61 67 65 20 69 73 20 61  a wiki page is a
08d0: 20 73 65 70 61 72 61 74 65 20 0a 5b 2e 2f 66 69   separate .[./fi
08e0: 6c 65 66 6f 72 6d 61 74 2e 77 69 6b 69 20 7c 20  leformat.wiki | 
08f0: 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74  control artifact
0900: 5d 0a 6f 66 20 74 79 70 65 20 5b 2e 2f 66 69 6c  ].of type [./fil
0910: 65 66 6f 72 6d 61 74 2e 77 69 6b 69 23 77 69 6b  eformat.wiki#wik
0920: 69 63 68 6e 67 20 7c 20 22 57 69 6b 69 20 50 61  ichng | "Wiki Pa
0930: 67 65 22 5d 2e 0a 0a 3c 68 32 3e 45 6d 62 65 64  ge"]...<h2>Embed
0940: 64 65 64 20 44 6f 63 75 6d 65 6e 74 61 74 69 6f  ded Documentatio
0950: 6e 3c 2f 68 32 3e 0a 0a 46 69 6c 65 73 20 69 6e  n</h2>..Files in
0960: 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 65   the source tree
0970: 20 74 68 61 74 20 75 73 65 20 74 68 65 20 22 2e   that use the ".
0980: 77 69 6b 69 22 20 73 75 66 66 69 78 20 63 61 6e  wiki" suffix can
0990: 20 62 65 20 61 63 63 65 73 73 65 64 0a 61 6e 64   be accessed.and
09a0: 20 64 69 73 70 6c 61 79 65 64 20 75 73 69 6e 67   displayed using
09b0: 20 73 70 65 63 69 61 6c 20 55 52 4c 73 20 74 6f   special URLs to
09c0: 20 74 68 65 20 66 6f 73 73 69 6c 20 73 65 72 76   the fossil serv
09d0: 65 72 2e 20 20 54 68 69 73 20 61 6c 6c 6f 77 73  er.  This allows
09e0: 0a 70 72 6f 6a 65 63 74 20 64 6f 63 75 6d 65 6e  .project documen
09f0: 74 61 74 69 6f 6e 20 74 6f 20 62 65 20 73 74 6f  tation to be sto
0a00: 72 65 64 20 69 6e 20 74 68 65 20 73 6f 75 72 63  red in the sourc
0a10: 65 20 74 72 65 65 20 61 6e 64 20 61 63 63 65 73  e tree and acces
0a20: 73 65 64 20 0a 6f 6e 6c 69 6e 65 2e 20 20 28 44  sed .online.  (D
0a30: 65 74 61 69 6c 73 20 61 72 65 20 64 65 73 63 72  etails are descr
0a40: 69 70 74 65 64 20 5b 2e 2f 65 6d 62 65 64 64 65  ipted [./embedde
0a50: 64 64 6f 63 2e 77 69 6b 69 20 7c 20 73 65 70 61  ddoc.wiki | sepa
0a60: 72 61 74 65 6c 79 5d 2e 29 0a 0a 53 6f 6d 65 20  rately].)..Some 
0a70: 70 72 6f 6a 65 63 74 20 70 72 65 66 65 72 20 74  project prefer t
0a80: 6f 20 73 74 6f 72 65 20 74 68 65 69 72 20 64 6f  o store their do
0a90: 63 75 6d 65 6e 74 61 74 69 6f 6e 20 69 6e 20 77  cumentation in w
0aa0: 69 6b 69 2e 20 20 54 68 65 72 65 20 69 73 20 6e  iki.  There is n
0ab0: 6f 74 68 69 6e 67 0a 77 72 6f 6e 67 20 77 69 74  othing.wrong wit
0ac0: 68 20 74 68 61 74 2e 20 20 42 75 74 20 6f 74 68  h that.  But oth
0ad0: 65 72 20 70 72 6f 6a 65 63 74 73 20 70 72 65 66  er projects pref
0ae0: 65 72 20 74 6f 20 6b 65 65 70 20 64 6f 63 75 6d  er to keep docum
0af0: 65 6e 74 61 74 69 6f 6e 20 61 73 20 70 61 72 74  entation as part
0b00: 0a 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 74  .of the source t
0b10: 72 65 65 2c 20 73 6f 20 74 68 61 74 20 69 74 20  ree, so that it 
0b20: 69 73 20 76 65 72 73 69 6f 6e 65 64 20 61 6c 6f  is versioned alo
0b30: 6e 67 20 77 69 74 68 20 74 68 65 20 73 6f 75 72  ng with the sour
0b40: 63 65 20 74 72 65 65 20 61 6e 64 0a 73 6f 20 74  ce tree and.so t
0b50: 68 61 74 20 6f 6e 6c 79 20 64 65 76 65 6c 6f 70  hat only develop
0b60: 65 72 73 20 77 69 74 68 20 63 68 65 63 6b 2d 69  ers with check-i
0b70: 6e 20 70 72 69 76 69 6c 65 67 65 73 20 63 61 6e  n privileges can
0b80: 20 63 68 61 6e 67 65 20 69 74 2e 20 20 0a 45 6d   change it.  .Em
0b90: 62 65 64 64 65 64 20 64 6f 63 75 6d 65 6e 74 61  bedded documenta
0ba0: 74 69 6f 6e 20 73 65 72 76 65 73 20 74 68 69 73  tion serves this
0bb0: 20 6c 61 74 74 65 72 20 70 75 72 70 6f 73 65 2e   latter purpose.
0bc0: 20 20 42 6f 74 68 20 66 6f 72 6d 73 20 6f 66 20    Both forms of 
0bd0: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 0a 75 73  documentation.us
0be0: 65 20 74 68 65 20 65 78 61 63 74 20 73 61 6d 65  e the exact same
0bf0: 20 77 69 6b 69 20 6d 61 72 6b 75 70 20 6c 61 6e   wiki markup lan
0c00: 67 75 61 67 65 2e 20 20 53 6f 6d 65 20 70 72 6f  guage.  Some pro
0c10: 6a 65 63 74 73 20 6d 61 79 20 63 68 6f 6f 73 65  jects may choose
0c20: 20 74 6f 0a 75 73 65 20 62 6f 74 68 20 66 6f 72   to.use both for
0c30: 6d 73 20 6f 66 20 64 6f 63 75 6d 65 6e 74 61 74  ms of documentat
0c40: 69 6f 6e 20 61 74 20 74 68 65 20 73 61 6d 65 20  ion at the same 
0c50: 74 69 6d 65 2e 20 20 42 65 63 61 75 73 65 20 74  time.  Because t
0c60: 68 65 20 73 61 6d 65 0a 66 6f 72 6d 61 74 20 69  he same.format i
0c70: 73 20 75 73 65 64 2c 20 69 74 20 69 73 20 74 72  s used, it is tr
0c80: 69 76 61 6c 20 74 6f 20 6d 6f 76 65 20 66 69 6c  ival to move fil
0c90: 65 20 66 72 6f 6d 20 77 69 6b 69 20 74 6f 20 65  e from wiki to e
0ca0: 6d 62 65 64 64 65 64 20 64 6f 63 75 6d 65 6e 74  mbedded document
0cb0: 61 74 69 6f 6e 0a 6f 72 20 62 61 63 6b 20 61 67  ation.or back ag
0cc0: 61 69 6e 20 61 73 20 74 68 65 20 70 72 6f 6a 65  ain as the proje
0cd0: 63 74 20 65 76 6f 6c 76 65 73 2e 0a 0a 3c 68 32  ct evolves...<h2
0ce0: 3e 42 75 67 2d 72 65 70 6f 72 74 73 20 61 6e 64  >Bug-reports and
0cf0: 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e   check-in commen
0d00: 74 73 3c 2f 68 32 3e 0a 0a 54 68 65 20 63 6f 6d  ts</h2>..The com
0d10: 6d 65 6e 74 73 20 6f 6e 20 63 68 65 63 6b 2d 69  ments on check-i
0d20: 6e 73 20 61 6e 64 20 74 68 65 20 74 65 78 74 20  ns and the text 
0d30: 69 6e 20 74 68 65 20 64 65 73 63 72 69 70 74 69  in the descripti
0d40: 6f 6e 73 20 6f 66 20 62 75 67 20 72 65 70 6f 72  ons of bug repor
0d50: 74 73 0a 62 6f 74 68 20 75 73 65 20 77 69 6b 69  ts.both use wiki
0d60: 20 66 6f 72 6d 61 74 74 69 6e 67 2e 20 20 45 78   formatting.  Ex
0d70: 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65 20 73  actly the same s
0d80: 65 74 20 6f 66 20 66 6f 72 6d 61 74 74 69 6e 67  et of formatting
0d90: 20 72 75 6c 65 73 20 61 70 70 6c 79 2e 0a 54 68   rules apply..Th
0da0: 65 72 65 20 69 73 20 6e 65 76 65 72 20 61 20 6e  ere is never a n
0db0: 65 65 64 20 74 6f 20 6c 65 61 72 6e 20 6f 6e 65  eed to learn one
0dc0: 20 66 6f 72 6d 61 74 74 69 6e 67 20 6c 61 6e 67   formatting lang
0dd0: 75 61 67 65 20 66 6f 72 20 64 6f 63 75 6d 65 6e  uage for documen
0de0: 74 61 74 69 6f 6e 0a 61 6e 64 20 61 20 64 69 66  tation.and a dif
0df0: 66 65 72 65 6e 74 20 6d 61 72 6b 75 70 20 66 6f  ferent markup fo
0e00: 72 20 62 75 67 73 20 6f 72 20 66 6f 72 20 63 68  r bugs or for ch
0e10: 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 2e  eck-in comments.
0e20: 0a                                               .