4509177ab2bab49626132a21f8f69ce043ca0aa5
[pandora-libraries.git] / docs / PXML_schema_plaintext.txt
1 1) at the root there is *exactly* one PXML block
2 2) inside this PXML block are >=1 <application> blocks
3         (required) id=DUMBFOLDERNAME
4         (optional) appdata=DUMBFOLDERNAME
5
6 inside each application block:
7 1) =1 <exec>
8         (required) command=TOKEN
9         (optional) arguments=TOKEN
10         (optional) background=BOOLEAN
11         (optional) startdir=DUMBPATH
12         (optional) standalone=BOOLEAN
13         (optional) x11=[req|stop|ignore]
14 2) >=1 <title>TEXT</title>
15         (required) lang=LANGCODE ( [a-zA-Z]{2,3}(_[a-zA-Z0-9]{2,3})* )
16 3) =1 <author>
17         (required) name=TEXT
18         (optional) website=anyURI
19         (optional) email=EMAILADDRESS
20 4) =1 <version>
21         (required) major=VERSION_NR
22         (required) minor=VERSION_NR
23         (required) release=VERSION_NR
24         (required) build=VERSION_NR
25 5) <=1 <osversion>
26         (required) major=VERSION_NR
27         (required) minor=VERSION_NR
28         (required) release=VERSION_NR
29         (required) build=VERSION_NR
30 6) >=0 <description>TEXT</description>
31         (required) lang=LANGCODE ( [a-zA-Z]{2,3}(_[a-zA-Z0-9]{2,3})* )
32 7) <=1 <icon>
33         (required) src=DUMBPATH
34 8) <=1 <previewpics>
35         (optional) >=0 <pic>
36                         (required) src=DUMBPATH
37 9) <=1 <info>
38         (required) name=TEXT
39         (required) type=[text/html|text/plain]
40         (required) src=DUMBPATH
41 10)=1 <categories>
42         (required) >=1 <category>
43                         (required) name=fdoCategory
44                         (optional) <subcategory>
45                                   (required) name=fdoSubCategory
46 11)<=1 <associations>
47         (required) >=1 <association>
48                         (required) name=TEXT
49                         (required) filetype=TOKEN
50                         (required) arguments=TOKEN
51 12)<=1 <clockspeed>
52         (required) frequency=positiveInteger
53
54
55
56 Filetype/variable explaination:
57 anyURI: should be some URL, no idea what exactly XML accepts there... (XML variable 'anyURI'!)
58 BOOLEAN: 0 or 1 or true or false (XML variable 'boolean'!)
59 DUMBFOLDERNAME: TEXT without ?>:/
60 DUMBPATH: TEXT without ?>:
61 EMAILADDRESS: [^@]+@[^\.]+\..+      in normal lang: something with an @ in the middle and some domain like thingie
62 LANGCODE: [a-zA-Z]{2,3}(_[a-zA-Z0-9]{2,3})*   example: en, eng, en_US, fur_IT
63 TEXT: The normalizedString data type also contains characters, but the XML processor will remove line feeds, carriage returns, and tab characters. (XML variable 'normalizedString'!)
64 TOKEN: The token data type also contains characters, but the XML processor will remove line feeds, carriage returns, tabs, leading and trailing spaces, and multiple spaces. (XML variable 'token'!)
65 VERSION_NR: [a-zA-Z0-9+-]*   example: 1, a, +svn, -svn, 123456789123456789
66
67 fdoCategory=AudioVideo|Audio|Video|Development|Education|Game|Graphics|Network|Office
68 fdoSubCategory=Building|Debugger|IDE|GUIDesigner|Profiling|RevisionControl|Translation|Calendar|ContactManagement|Database|Dictionary|Chart|Email|Finance|FlowChart|PDA|ProjectManagement|Presentation|Spreadsheet|WordProcessor|2DGraphics|VectorGraphics|RasterGraphics|3DGraphics|Scanning|OCR|Photography|Publishing|Viewer|TextTools|DesktopSettings|HardwareSettings|Printing|PackageManager|Dialup|InstantMessaging|Chat|IRCClient|FileTransfer|HamRadio|News|P2P|RemoteAccess|Telephony|TelephonyTools|VideoConference|WebBrowser|WebDevelopment|Midi|Mixer|Sequencer|Tuner|TV|AudioVideoEditing|Player|Recorder|DiscBurning|ActionGame|AdventureGame|ArcadeGame|BoardGame|BlocksGame|CardGame|KidsGame|LogicGame|RolePlaying|Simulation|SportsGame|StrategyGame|Art|Construction|Music|Languages|Science|ArtificialIntelligence|Astronomy|Biology|Chemistry|ComputerScience|DataVisualization|Economy|Electricity|Geography|Geology|Geoscience|History|ImageProcessing|Literature|Math|NumericalAnalysis|MedicalSoftware|Physics|Robotics|Sports|ParallelComputing|Amusement|Archiving|Compression|Electronics|Emulator|Engineering|FileTools|FileManager|TerminalEmulator|Filesystem|Monitor|Security|Accessibility|Calculator|Clock|TextEditor|Documentation|Core|KDE|GNOME|GTK|Qt|Motif|Java|ConsoleOnly