home *** CD-ROM | disk | FTP | other *** search
/ linuxmafia.com 2016 / linuxmafia.com.tar / linuxmafia.com / pub / palmos / development / doc-format < prev    next >
Text File  |  2003-01-12  |  13KB  |  334 lines
  1. About the DOC Format
  2.  
  3.  
  4.  
  5.  
  6. DOC:
  7.  
  8. The standard document format for large text documents on PalmOS is 
  9. named DOC (given in all caps, here, to distinguish it from similarly-named 
  10. formats).  Rick Bram (rickbram@digitalglyph.com) created that format, and 
  11. then the original "Doc" reader program (aka "DOC" or "PilotDoc" or "PilotDOC").
  12. Some contributions to the spec and additional utilities also came from Florent 
  13. Pillet, Mark Pierce, Pat Beirne (patb@corel.com), Harold Bamford, Masatoshi 
  14. Yoshizawa, and others.  I've found a copy of Doc v. 1.44, and have it here 
  15. (binary only).  DOC-file filenames end in extension .prc or .pdb.  The data 
  16. are stored compressed.  DOC files contain an internal document-name string.  
  17. Many e-books have been released in DOC format.
  18.  
  19. Bram turned over development of the no-licence-stated[1] DOC reader to 
  20. Aportis (http://www.aportis.com/), which has released sundry proprietary 
  21. binary-only ("shareware") versions.
  22.  
  23. MakeDoc:
  24.  
  25. Bram then collaborated with Pat Beirne and Harold Bamford to create the 
  26. MakeDoc utility (makedoc7.cpp).  Many Web sites (and the Pilot HOWTO) 
  27. reference it and related documents at Bram's long-vanished 
  28. http://www.concentric.net/~rbram/ pages.  I found a copy of the source 
  29. code elsewhere, and have it here (licence fixed 2000-12-01 by the author).
  30. Converts HTML (stripping tags) or ASCII to DOC format, and converts 
  31. DOC to ASCII.
  32.  
  33. Berne's final versions of MakeDoc were called MakeDocJ and were coded in
  34. Java (available here).   I also have Jeffrey A. Krzysztow's (brisk@qni.com)
  35. later variant form of MakeDocJ.
  36.  
  37.  
  38.  
  39.  
  40.  
  41. Later Free-Software / Open Source Tools (almost all available here):
  42.  
  43. o   CSpotRun, GPLed DOC reader for PalmOS.   Source and PalmOS binary code,
  44.     in separate archives.
  45.     http://www.32768.com/bill/palmos/cspotrun/
  46.  
  47. o   Doc Toolkit:  Python scripts to convert HTML/ASCII to/from DOC.
  48.     http://pyrite.linuxave.net/dtk/dtk.html
  49.     http://purl.oclc.org/net/n9mtb/cq/
  50.  
  51. o   doc2prc.zip:  MS-DOS program to convert MS-Word 6.0 format to DOC.  
  52.     http://wuarchive.wustl.edu/systems/mac/amug/files/pilot/pc/
  53.  
  54. o   docname.zip: MS-DOS utility to change the internal name of a DOC file.
  55.     http://wuarchive.wustl.edu/systems/mac/amug/files/pilot/pc/
  56.  
  57. o   DocReader:  Win32 reader for DOC.  Delphi4 source code.
  58.     http://www.crosswinds.net/~mpicker0/DocReader/DocReaderFr.htm
  59.  
  60. o   DocReader for Java:  Java source and bytecode.
  61.     http://world.std.com/~cwong/reader/index.html
  62.  
  63. o   doctype is a shell script for Unix platforms to tell which PalmOS program
  64.     can read a .pdb document, and whether a db or .prc file is a document
  65.     file, a PalmOS application, or a PalmOS Hack extension.  Supports DOC
  66.     among many others.
  67.     http://freshmeat.net/projects/doctype/
  68.  
  69. o   gPalmDoc is an X11/GTK+ -based HTML-DOC converter.
  70.     http://users.linuxbox.com/~jiva/  (Site vanished, but the source is
  71.     preserved in this site's other-os directory.)
  72.  
  73. o   makedoc7.zip:  MS-DOS port of Beirne's MakeDoc.  Converts HTML (stripping
  74.     tags) or ASCII to DOC, and converts DOC to ASCII. 
  75.     http://wuarchive.wustl.edu/systems/mac/amug/files/pilot/pc/
  76.  
  77. o   MakeDocJ, an LGPLed successor to Beirne's MakeDoc and MakeDocJ, by
  78.     Jeffrey A. Krzysztow.  Converts HTML (stripping tags) or ASCII to DOC, and 
  79.     converts ASCII to DOC.  Java source and bytecode.  Web page says he got 
  80.     DOC format details at www.RoadCoders.com (which no longer has them).
  81.     http://www.qni.com/~brisk/PalmPilot/MakeDocJ/
  82.  
  83. o   MakeDocW, Win32 port of MakeDoc, by Mark Pierce.  Converts HTML (stripping
  84.     tags) or ASCII to DOC, and converts DOC to ASCII. 
  85.     http://www.pierce.de/makedocw.html
  86.     http://wuarchive.wustl.edu/systems/mac/amug/files/pilot/pc/
  87.     http://www.robofish.com/download/utils/
  88.  
  89. o   PalmLib is a set of PHP3 functions to on-the-fly convert ASCII or HTML 
  90.     to DOC format, by Pierre Dittgen.
  91.     http://mmmm.free.fr/palm/
  92.  
  93. o   Pilot Screwdriver:  CGI/Perl HTML-to-DOC converter, by Christopher Heschong
  94.     http://pilot.screwdriver.net/
  95.  
  96. o   ReadDocJ is a DOC reader for any platform with a Java Runtime Environment.
  97.     By Jeffrey a. Krzysztow.
  98.     http://www.qni.com/~brisk/PalmPilot/ReadDocJ/
  99.  
  100. o   RichReader converter source code for *ix (ConverterSource.zip).
  101.     Contains a "modified version" of makedoc7.cpp.  Converts among RTF, 
  102.     HTML, PDF, and DOC.  All included converters are either open source 
  103.     or freely distributable source code of some type (e.g., the makedoc7.cpp
  104.     variant).  From the creator of the RichReader DOC reader.  Available here.
  105.     http://users.rcn.com/arenamk/RichReader.html   
  106.  
  107. o   Sitescooper:  HTML-to-DOC conversion scripts, by Justin Mason.
  108.     Preconfigured for popular Web-based news sites.
  109.     http://sitescooper.org/
  110.     http://sourceforge.net/projects/sitescooper/
  111.  
  112. o   txt2pdbdoc utilities.  Freely distributable source code.  Contains:
  113.        txt2pdbdoc: ASCII to DOC converter.
  114.        html2pdbtxt: HTML to DOC.
  115.        pdbtxt2html: DOC to HTML.
  116.     http://www.best.com/~pjl/software.html
  117.     ftp://shell3.ba.best.com/pub/pjl/software/txt2pdbdoc-1.2.1.tar.gz 
  118.     http://homepage.mac.com/pauljlucas/software.html
  119.  
  120. o   Z-DOC, a GPLed DOC reader for PalmOS.  Source and PalmOS binary code.   
  121.     Pretty buggy, when I last tried it. 
  122.     http://www.geocities.com/Area51/7689/pilot.html
  123.  
  124. o   ZDOCm is mizotec's revision/update of Z-DOC.  Source and PalmOS binary
  125.     code.  Still a bit buggy.  
  126.     http://member.nifty.ne.jp/mizotec/
  127.  
  128.  
  129.  
  130.  
  131. Later Proprietary Tools:
  132.  
  133. o   ActiveX Controls for PalmPilot DOC Conversion.  Based on Beirne's
  134.     MakeDoc.
  135.     http://www.pierce.de/controls.html
  136.  
  137. o   AportisDoc Professional, AportisDoc Mobile Edition.  AportisDoc PDF
  138.     Converter for Win32.  DOC readers/utilities.
  139.     http://www.aportis.com/
  140.  
  141. o   Avigo Doc Viewer is a DOC-reader for the TI Avigo.  Licence unstated.
  142.     http://www.pmssystem.de/avigo/pcbased.htm
  143.  
  144. o   BigDOC DOC-editor for Win32.
  145.     http://www.visionary2000.com/bigdoc/
  146.  
  147. o   BookViewer reader for MS-WindowsCE.
  148.     http://www.geocities.com/ResearchTriangle/Lab/3533/palm_sw2.html#docs
  149.  
  150. o   BookWormie is a DOC-reader for PalmOS (?)
  151.     http://www.ipda-asia.com/index.htm
  152.  
  153. o   ClipSync data-transfer/converter utility.  Can output DOC format.
  154.     http://www.goclipsync.com/
  155.  
  156. o   DocInOut Win32 converter/editor for DOC and other formats, by Skip Bremer.
  157.     http://www.dco.net/go/wps/download/docinout.zip
  158.     http://www.handbase.com/files/docinout26.zip
  159.     http://www.zdnet.co.uk/software/free/pilot/docs/sw11.html
  160.  
  161. o   DOCit Win32 DOC viewer/editor
  162.     http://www.gacel.de/docit.htm
  163.  
  164. o   Doc On Demand ASCII-to-DOC converter.  Perl script accessible via CGI.
  165.     http://www.poormojo.org/dod.html
  166.  
  167. o   Documents To Go editor/converter for Win32 and MacOS.  Can output DOC.
  168.     http://www.dataviz.com/products/documentstogo/jump/dxtg_jump.html
  169.  
  170. o   DocRead is a binary-only, freely distributable DOC reader for HP 100LX 
  171.     / HP 200LX.
  172.     http://www.tuug.org/~hysky/
  173.  
  174. o   DOCView / DOCViewH32 / DOCViewHPC reader for MS-WindowsCE.
  175.     http://www.geocities.com/ResearchTriangle/Lab/3533/palm_sw2.html#docs
  176.  
  177. o   EasyDOC Viewer for Win32.
  178.     http://www.pilotyid.com/easydoc.html
  179.  
  180. o   EBook is a DOC-reader for EPOC/Psion.
  181.     http://www.geocities.com/ebookepoc/
  182.  
  183. o   HandDoc Editpad:  Editor/viewer.
  184.     http://www.palmedata.com.au/
  185.  
  186. o   iambic Reader (formerly DocVis) DOC reader.  Also supports HTML. 
  187.     http://www.iambic.com/pilot/reader/
  188.  
  189. o   InstallBuddy:  Document-converter for Win32 that does DOC.
  190.     http://www.backupbuddy.com/ib/prod_installbuddy_details.html
  191.  
  192. o   iSilo / iSilo Web / iSilo Maker / iSilo free: Reader/utilities for 
  193.     DOC or HTML.  (Formerly ToGo.)
  194.     http://www.isilo.com/
  195.  
  196. o   J-DOC reader.  Most-recent versions are Japanese-language-only.
  197.     http://www.tt.rim.or.jp/~tatsushi/palmware.html#jdoc
  198.  
  199. o   Mac Palm Doc:  Conversion utility for MacOS.
  200.     http://www.plumisland.com/macpalmdoc/index.html
  201.  
  202. o   MakeIt:  Converts HTML to DOC.  Win32.  http://xyz.com.mx/pilot/makeit.html
  203.  
  204. o   Makedoc8.exe:  DOS port of Beirne's makedoc8.cpp.
  205.     http://www.memoware.com/makedoc8.exe
  206.  
  207. o   MakeDocBatch:  HTML-to-DOC converter for Win32.
  208.     http://www.tomcheng.com/comp/
  209.  
  210. o   MakeDocDD, MacOS port of MakeDoc.  Gratis-usage.  Converts HTML (stripping
  211.     tags) or ASCII to DOC, and converts DOC to ASCII.
  212.     http://www.pluto.dti.ne.jp/~yoz/PilotSoft-e.html
  213.  
  214. o   MakeTeal.  HTML to DOC converter for Win32.  
  215.     http://www.io.com/~bryce/maketeal.html
  216.  
  217. o   MegaDoc.  Reader for DOC, ASCII, HTML, RTF, and unspecified versions of
  218.     Microsoft Word.  http://megasoft2000.tripod.com/
  219.  
  220. o   Mobile LinkDoc.  DOC reader.
  221.     http://www.mobilegeneration.com/products/linkdoc/
  222.  
  223. o   MobiPocket Reader / MobiBook Reader:  Reader bundled with e-books.
  224.     Versions for PalmOS, EPOC/Psion, MS-WindowsCE, and PocketPC.  Company
  225.     also offers DOC-publishing software.
  226.     http://www.mobipocket.com/en/HomePage/default.asp
  227.  
  228. o   Newt's Cape PilotDOC plug-in is DOC reader code for Apple's Newton.
  229.     http://members.bellatlantic.net/~sweyer/newton/newtscape/pilotdoc.html
  230.  
  231. o   PalmBuddy:  Utility for MacOS that converts DOC.
  232.     http://perso.wanadoo.fr/fpillet/
  233.  
  234. o   PanaRead.  DOC reader.  http://www.panamedia.com/
  235.  
  236. o   PDF2Doc.   Win32 PDF to DOC converter.  http://tinystocks.com/pdf2doc.html 
  237.  
  238. o   PalmDocs:  MS-Word - DOC converter for Win32.
  239.     http://www.visionary2000.com/palmdocs/
  240.  
  241. o   PeanutReader.  DOC reader.  Packaged with "e-books".
  242.     http://www.peanutpress.com/
  243.  
  244. o   pedit / pedit32 / peditPro / peditLight: Win32 DOC editor/converter.
  245.     http://home.columbus.rr.com/nevai/palm/
  246.  
  247. o   PeekABook reader for MS-WindowsCE.
  248.     http://www.oopdreams.com/ce/peekabook/
  249.  
  250. o   Primer PDF-to-DOC converter for Win32, and PalmOS DOC-viewer.
  251.     http://www.ansyr.com/products/primerpalm.asp
  252.  
  253. o   QED:  DOC reader and editor.  http://www.visionary2000.com/qed/
  254.  
  255. o   QEX:  DOC-converter for Win32.
  256.     http://www.visionary2000.com/qed/qex.htm
  257.  
  258. o   Qvadis Express Reader DX, Qvadis Express Reader GT, Qvadis Express 
  259.     Reader Pro.  DOC readers, etc.  
  260.     http://www.qvadis.com/expressreader/support.html
  261.  
  262. o   QuickWord (formerly SmartDoc).  Reader and editor.  Portions are
  263.     for Win32, portions for PalmOS.  http://www.cesinc.com/quickword/
  264.  
  265. o   RichReader.  Reader for DOC, but also PDF, RTF, or HTML files that have
  266.     been run through the provider converter utilities (also listed separately).
  267.     Formerly HTML2D, WRTF2Doc, and RTF2Doc.  
  268.     http://users.rcn.com/arenamk/RichReader.html
  269.  
  270. o   Smoothy.  Reader for DOC.
  271.     http://www.handwave.com/
  272.  
  273. o   Starbuck DOC reader for MS-WindowsCE.
  274.     http://www.thumbsupsoft.com/maphtm/starbuck.html
  275.  
  276. o   TakeNote.  DOC editor/reader.  http://www.landware.com/products/takenote/
  277.  
  278. o   TealAgent:  HTML/DOC-converter and PalmOS viewer for Win32 and MacOS.
  279.     http://www.tealpoint.com/softagnt.htm
  280.  
  281. o   TealDoc.   DOC reader.  http://www.tealpoint.com/softdoc.htm
  282.  
  283. o   TomeRaider:  DOC reader for PalmOS, Win32, EPOC/Psion, and PocketPC.
  284.     http://www.tomeraider.com/
  285.  
  286. o   TWord:  DOC-creator for Win32.
  287.     http://www.geocities.com/ResearchTriangle/System/2633/pilot.htm
  288.  
  289. o   VReader5 is a DOC-reader for EPOC/Psion.
  290.     http://members.maxonline.at/Five4U/techworld/home.html
  291.  
  292. o   Web2Doc is an HTML-DOC converter for Win32.
  293.     http://home.netvigator.com/~clarenho/Web2Doc/
  294.  
  295. o   Word To Doc.  MS-Word - DOC converter for Win32.
  296.     http://www.geocities.com/dilemma_design/DOCMain.htm
  297.  
  298. o   WordSmith.  Editor, using RTF as native format.
  299.     http://www.bluenomad.com/
  300.  
  301.  
  302.  
  303.  
  304. Other Resources:
  305.  
  306. o   Listings of document readers for PalmOS.
  307.     http://www.handheldnews.com/file.asp?ObjectID=5733
  308.  
  309. o   Comparative review of 15 DOC readers.
  310.     http://www.the-gadgeteer.com/docreaders-review.html
  311.  
  312. o   Memoware's "Making Document Files" page.
  313.     http://www.memoware.com/mw-helpm.htm
  314.  
  315. o   Jim Thompson's "Wordprocessing" (on PalmOS) page.
  316.     http://www.jimthompson.net/pilot/wordproc.htm
  317.  
  318. o   How to Generate DOC Files for Handheld Devices Using Lotus Notes
  319.     http://www.dominopower.com/issuesprint/issue199904/dompalm.html
  320.  
  321.  
  322. [1] Source code (lawfully) released to the public without an explicit 
  323. licence is technically _proprietary_ software, as recipients have (under 
  324. USA law, at least) only the implied right to download, compile, use,
  325. and modify it, and to distribute modifications as patches -- but not 
  326. to further distribute the original code, or modified versions thereof.
  327. As the saying goes, no licence means unlicensed.
  328.  
  329. But programmers should beware of the no-licence issue:  All the claims 
  330. you see of such code being "freely distributable" or "public domain" 
  331. (just because they lack an explicit licence) are, strictly speaking, 
  332. factually in error.
  333.  
  334.