Die Historie von UDO Release 3-0.17 17. April 1995 von Dirk Hagedorn In der Esmecke 9 D-59846 Sundern MausNet: Dirk Hagedorn @ MK2 Inhaltsverzeichnis ================== 1 Historie 1.1 Release 3 gegenber Release 2 1.1.1 Version 3-0.17 1.1.2 Version 3-0.16 1.1.3 Version 3-0.15 1.1.4 Version 3-0.14 1.1.5 Version 3-0.13 1.1.6 Version 3-0.12 1.1.7 Version 3-0.11 1.1.8 Version 3-0.10 1.1.9 Version 3-0.09 1.1.10 Version 3-0.08 1.1.11 Version 3-0.06 1.1.12 Version 3-0.05 1.2 Release 2 gegenber Release 1 1.3 Release 1 gegenber Private Release 7 1 Historie ========== An dieser Stelle findet man eine kurze Beschreibung der nderungen, die zwischen den einzelnen Versionen von UDO aufgetreten sind. Das ist zwar eine Menge Krempel, dient aber nicht nur mir als kleine Gedchtnissttze. 1.1 Release 3 gegenber Release 2 --------------------------------- 1.1.1 Version 3-0.17 Eine falsche Abfrage fhrte zu berflssigen Fehlermeldungen bei der Umwandlung nach TeX, RTF und PC-Help. Bei der Wandlung nach ST-Guide wird '!label' nun durch '@symbol' und nicht durch '@index' ersetzt. '!image' hat ein eigenes Kapitel in der Anleitung bekommen. 1.1.2 Version 3-0.16 Einen blen Bug beim Silbenumbruch beseitigt. Warum trat der blo jetzt erst auf? GEM: Fenstertitel angepat. GEM: Hinweis-Button in 'Einstellungen' vegrert. Dokus geschrieben bzw. erweitert 1.1.3 Version 3-0.15 TTP: Asche auf mein Haupt! Das TTP strzte ab, wenn man ein Logfile benutzte (also nicht -l bergab). GEM: Dateinamen werden jetzt in den Dialogen mit einem Leerzei- chen Abstand innerhalb der Buttons dargestellt. Beim Falcon-TOS waren teilweise Zeichen nur zur Hlfte sichtbar. Neues Kommando '!stg_short_title'. Taucht dieses Kommando vor '!maketitle' auf, so werden in der "Titelseite" keine Leerzei- len benutzt. Ich finde es aber hlich, mu ich gleich dazusagen. Grrr, natrlich sollten die mit '!hyphen' erzeugten Trennvor- schlge nicht bei jedem, sondern nur bei den Worten berprft werden, die nicht mehr in eine Zeile passen! Und so wird es jetzt auch gemacht. ;-) Ein paar kleinere Optimierungen. Zum ersten Male habe ich den Profiler schtzen gelernt, auch wenn er mir andauernd absemmelt. 1.1.4 Version 3-0.14 GEM: Auch unter SingleTOS kann man nun Programme starten. Aber Vorsicht: it's a hack, man! GEM: Man kann nun fr Quell- und Zieldatei einen eigenen Viewer und Editor zuweisen. GEM: Man kann nun eine (wenn auch kurze) Kommandozeile an die externen Programme bergeben. Dabei kann man auf folgende Platz- halter zurckgreifen: - $I: Quelldatei - $O: Zieldatei - $L: Logdatei - $C: Pure-C-Helpcompiler-Kommandodatei Beim Wandeln nach PC-Help wird nun automatisch eine Komman- dodatei fr den Pure-C-Hypertextcompiler erzeugt, falls noch keine existiert. UDOSHELL.APP heit nun UDOSH.APP. Grund: demnchst wird es auch eine englische Version geben, die dann UDOSHENG.APP heien wird. Der Silbenumbruch kann nicht mehr abgeschaltet werden. Er funk- tioniert, also gibt es keinen Grund, ihn nicht zu benutzen. Und nochmal habe ich etwas beim Suchen nach Include-Dateien verndert. Wird kein kompletter, absoluter Pfad angegeben, so bastelt UDO erstmal anhand des Pfades der Hauptdatei den Pfad der Include-Datei zusammen und versucht, die Datei zu ffnen. Scheitert dies, so wird nochmal der bergebende Pfad benutzt. Vorher war die Reihenfolge genau umgekehrt und zumeist ging das erste ffnen in die Hose (hi Manfred). Konnte eine Datei nicht geffnet werden, so erfolgt nun auch eine Ausgabe ins Logfile. GEM: Die Alertboxen, die erscheinen, wenn eine datei nicht geff- net werden konnte, wurden um einen Abbruch-Button erweitert. Doku aufgeteilt in Hauptteil, Referenz und History. Neues Kommando '!hyphen'. Dieser Befehl ist vorsichtig zu ge- nieen und hat ein eigenes Kapitel bekommen. Seht Euch bitte HYPHENS.UI an, darin sind etliche Beispiele enthalten. Die Rei- henfolge der Trennvorschlge ist enorm wichtig. Kurze Zeilen werden im Logfile bemngelt. Eine Zeile ist dann kurz, wenn sie nicht lnger als 64 Zeichen ist. Im Logfile wird jeweils das Wort angegeben, welches nicht mehr in eine Zeile pate, angegeben. Im Sourcecode zwei < durch <= ersetzt. Dadurch sollten Zeilen jetzt nicht frher als ntig umgebrochen werden. Mal sehen, ob's funktioniert. TTP: -o funktioniert jetzt auch. In der Mupfel mu man die Tilde quoten, da die Mupfel sonst $HOME einsetzt! TTP: Fehlerhafte Hilfsausgabe bezglich -o korrigiert. TTP: Auch hier wird jetzt ein korrektes Logfile erzeugt. GEM: Es erscheint kein Dialog mehr bei der Umwandlung, sondern es wurden zwei Info-Zeilen mit in den Hauptdialog bernommen. Dadurch ist der bersetzungsvorgang etwas schneller und kann im Hintergrund laufen. Die Anzahl der Nodes etc. kann man dem Log- file entnehmen. Der Underscore wurde bei der "Labelanpassung" nicht korrekt gewandelt. '!short_toc' wurde irgendwie wegoptimiert und ist jetzt natr- lich wieder vorhanden. Die Zeilen des Anhangs im Inhaltsverzeichnis werden nun um ein Leerzeichen weiter eingerckt, damit der Anhang bndig mit dem Inhaltsverzeichnis dargestellt wird. 1.1.5 Version 3-0.13 TeX mag keine Umlaute und Sonderzeichen in einem Label. Dies wird nun automatisch bercksichtigt durch Wandlung von '"a' in 'ae' etc. Natrlich wird die gleiche Umwandlung auch bei !link vorgenommen. GEM: Button 'Ende' hat nun keinen Shortcut mehr. Fehler in der Doku bezglich Option -o beseitigt. Man mute schon immer das Outfile durch Leerzeichen getrennt bergeben. Images werden beim ST-Guide nun ein Zeichen weiter eingerckt. Zentrierter Text hat rechts keine berflsigen Leerzeichen mehr. GEM: Name der Zieldatei kann differenzierter angepat werden. TTP: Als Zieldatei kann nun auch die Tilde angegeben werden. Dann pat UDO den Namen der Zieldatei wie bei der GEM-Version komplett an. Es kann ein Logfile angelegt werden, in welches Fehlermeldungen ausgegeben werden. Diese Fehlermeldungen bestehen jeweils aus einem '!', dem Dateinamen und der Zeilennummer, gefolgt von einer kurzen Fehlerbeschreibung. Folgende Dinge werden nun bemngelt: - !item ohne !begin_... - !end_itemize ohne !begin_itemize - !end_enumerate ohne !begin_enumerate - !end_description ohne !begin_description - !end_document ohne !begin_document - !end_appendix ohne !begin_appendix 1.1.6 Version 3-0.12 Bei der Description-Umgebung gab's noch einen heftigen Bug, der genau dann zuschlug, wenn man direkt hinter der zweiten eckigen Klammer noch direkt ein oder mehrere Zeichen angefgt hatte. Vielen Dank an Peter Klasen und Manfred Ssykor! Da war ich wohl etwas voreilig. Die Grafikeinbindung fr Lindner- TeX war ja wohl nichts. Daher gibt es jetzt ein neues Kommando: '!tex_dpi'. Zweck: IMGTOTEX verndert den Header eines GEM- Images und bentigt dazu eine DPI-Angabe. Da UDO nun auch selb- stndig den GEM-Header anpassen (kann und mu) und damit IMGTOTEX vollstndig ersetzt, mu man UDO die DPI-Angabe mit '!tex_dpi' angeben. Es sind nur ganzzahliger positive Werte mglich. Bilder werden beim Lindner-TeX immer zentriert ausgege- ben. '!tex \input graphic' mu manuell vorgenommen werden! Grrrr, wenn jetzt dieser blde DVI-Viewer absolute Pfade akzep- tieren wrde... UDO erzeugt bei der Bildeinbindung ein paar Kommentare innerhalb des Files. Knnt Ihr Euch ja mal interessehalber ansehen. Die Kommentare fliegen denmchst heraus. 1.1.7 Version 3-0.11 Effektverwaltung auch bei der Description-Umgebung angepat. Silbenumbruch ist defaultmig eingeschaltet (auch beim TTP). Neues Komando '!tex_lindner', welches angibt, da die Image- Einindung fr das Lindner-D-59846 Sundernex vorgenommen werden soll. Neues Komando '!tex_strunk'. Dito fr das Strunk-TeX. Neues Komando '!image', durch welches man beim ST-Guide und TeX Bilder einbinden kann. Beim ST-Guide wird gleichzeitig die pas- sende Anzahl an Leerzeilen mit ausgegeben (ausgerichtet am 6 x 6 Systemfont). Die TeX-Einbindung wurde bereits mit dem CS-(Strunk- )TeX getestet. Ob's auch mit dem Lindner-TeX funktioniert, das wird sich am Wochenende zeigen. ;-) 1.1.8 Version 3-0.10 Neues Kommando '!rtf_no_quotes'. Huch, bei der internen Umstellung der Effekte gab's beim RTF- Format nur noch Murks. Jetzt wieder OK. Auch beim RTF-Format wird die Description-Umgebung nun geschach- telt dargestellt. 1.1.9 Version 3-0.09 !\, } und { werden jetzt bei der RTF-Ausgabe richtig gequotet. Endlich! Der Umbruch einer Zeile erfolgt nun auch bei den in einem Wort angegebenen Trennhilfen '!-'! Der nchste Akt wird folgender sein: Auswertung und Benutzung der Trennregeln aus ghyphen.tex von TeX. Wei jemand, wie diese einzelnen Trennre- geln aufgebaut sind? Wurde UDOSHELL ohne Dateibergabe gestartet, stand bei der Ziel- datei nur eine Endung. Im Dialog heit 'OK' jetzt 'Konvertieren' und ist auch via Men erreichbar. Einen dicken Bug beim Entfernen der Whitespaces am Anfang einer Zeile beseitigt. Peinlich, peinlich... Nochmal die interne Verwaltung des Inhaltsverzeichnisses gen- dert. Die Ergebnisse sollten die gleichen geblieben sein. Nur, UDO belegt im Ruhezustand jetzt nur noch ca. 350kb (anstatt 900kb vorher). Hi Andreas! ;-) Aufgrund dieser nderungen gelten folgende neue Grenzen: maximal 512 Nodes, Subnodes, Subsubnodes, maximal 512 Label Keine Alertbox mehr bei Drag & Drop. Ist Alternate beim Draggen einer Datei auf das UDO-Fenster gedrckt, so wird die Datei als Zieldatei eingesetzt, andernfalls als Quelldatei. Alternate wird genau wie bei Drag & Drop auch bei VA_START ausgewertet. Wieder eine kleine nderung bei der Description-Umgebung. Die erste Zeile wird um jeweils ein Leerzeichen weiter eingerckt. Durch diese kleine nderung lt sich die Description-Umgebung nun auch schachteln. :-) HTML-Format begonnen. Ist aber noch nicht fertig. Die momentanen Ausgaben sind also noch unbrauchbar. Effekte werden intern nun anders verwaltet. Vorher gab's Proble- me mit der Beachtung der Zeilenlnge, da Effekte der Zeilenlnge hinzuaddiert wurden. 1.1.10 Version 3-0.08 Version 3-0.07 ging nur zwecks RTF-Test an Christoph Spengler. Umfangreiche nderungen an der Shell. Sie wird nun ihrem Namen gerecht und kann Programme parallel starten. "Parallel starten" heit soviel, da dies nur funktioniert, wenn man - Mag!X oder MultiTOS benutzt - UDO als Accessory unter Gemini benutzt - UDO als Applikation benutzt und das externe Programm als Accessory luft und VA_START versteht. Der Wandlungsvorgang kann durch Shift-Shift unterbrochen werden. Es erfolgt dann zunchst eine Abfrage. Whrend der Umwandlung werden einige zustzliche Informationen ausgegeben. "berschreiben" ist nun der Default-Button in der nervigen Alert- box. (Demnchst kann man sie abschalten) VA_START wird korrekt ausgewertet. Die Einstellungen knnen nun gesichert werden. UDO.INF wird wie die Schlsseldatei auch in $HOME bzw. im aktuellen Verzeichnis gesichert. Ich habe versucht, die Probleme bei der Description-Umgebung In den Griff zu bekommen. Sie lt sich immer noch nicht schach- teln. Taucht allerdings mehr als ein Absatz bei einem Aufzh- lungspunkt auf, so sollte dieser auch korrekt eingerckt werden. UDO hat nun eine "Silbentrennung" implementiert, d.h da UDO lange, durch Bindestriche geteilte Wrter beim Zeilenumbruch bercksichtigt. Da ich die "Silbentrennung" noch nicht ausgiebig genug getestet habe, ist sie defaultmig abgeschaltet. *BITTE VORSICHT BEIM EINSATZ!!!!!*. Vorher wichtige Dinge sichern. 1.1.11 Version 3-0.06 Befehle mssen nicht mehr am Anfang stehen, sondern knnen auch durch Whitespaces (Leerzeichen und Tab) eingerckt werden. !description-Umgebung UDO-Kommandos knnen durch '!/' gequotet werden. Neues Kommando '!label' Bei PC-Help werden nun alle Labels im Titel eingetragen. Bei PC-Help werden alle Referenzen automatisch gesetzt. Findet UDO bei '!include' eine Datei nicht, so wird ein neuer Dateiname gebildet und erneut versucht, diese Datei zu ffnen. Der Dateiname wird gebildet aus Laufwerkskennung und Pfad der Hauptdatei zzgl. der Angaben bei '!include'. Fehlt hier die Da- teiendung, so wird '.ui' eingesetzt. Ich hoffe, da dieses Verfahren funktioniert. ;-) Kommando '(!..)' heit nun '!..' (die Klammern sind also ent- fallen). Leider ist es nicht mglich, die ... immer nach '\ldots' ersetzen zu lassen, da es sonst Probleme mit '\verb' gibt. Kommando '!-' entfallen. Wenn man nicht nach TeX wandelt, so werden alle doppelten und dreifachen Bindestriche durch einen Bindestrich ersetzt. Die Kommandos '!TeX', '!LaTeX' und '!Metafont' werden bei der Wandlung nach TeX durch '\TeX', '\LaTeX' bzw. '\Metafont' (ist das so richtig?) ersetzt, ansonsten das Ausrufungszeichen gefiltert. RSC-Datei berarbeitet fr 3D-Look unter MultiTOS. Scrollen via Tastatur im Fenster mglich. Kleinen Bug beim Drag & Drop beseitigt. '!propfont' heit nun '!rtf_propfont'. '!monofont' heit nun '!rtf_monofont'. '!noheadlines' heit nun '!stg_no_headlines'. Bei der Wandlung nach ST-Guide wird bei '!maketitle' '@autorefoff/on' benutzt. Neues Kommando '!asc_no_effects', welches dazu fhrt, da UDO bei der Wandlung nach ASCII keine "DF-Effekte" benutzt. Kommando '!shorttoc' entfallen. Neue Kommandos '!asc_short_toc', '!stg_short_toc', '!pch_short_toc', und '!1wp_short_toc' Bei der Itemize-Umgebung werden nun nicht zwei Leerzeichen nach den Markierungen ausgegeben, sondern nur noch eins. Dafr wird vor der Markierung ein weiteres Leerzeichen ausgegeben. Neues Kommando '!-', welches fr TeX durch die Trennhilfe '"-' ersetzt wird und beim Rest gefiltert wird. Die GEM-Version beanstandet nach einem Vorgang eine ungerade Anzahl von "" und ''. Stack der GEM-Version vorsichtshalber auf 64k aufgeblht. Vorher war UDO mir einmal abgesemmelt und ich wei nicht, warum!?! 1.1.12 Version 3-0.05 erste GEM-Version von UDO. Wie man sie bedient, sollte selbster- klrend sein. UDO benutzt jetzt beim TTP als Default deutschsprachige Ausga- ben. UDO kann jetzt auch nach RTF wandeln! Automatisch wird bei RTF fr !begin_document der RTF-Header mit allen bentigten Absatz- formaten, Fonts, Kopfzeilen etc. eingefgt. Das Layout wird hnlich TeX gesetzt. Ebenso die Fontgren. Interne Verwaltung des Inhaltsverzeichnisses gendert. Nun sind maximal 20 Nodes mit je 20 Subnodes mit je 20 Subsubnodes verfgbar. Bei der Ausgabe fr den ST-Guide wird jetzt '@toc' benutzt, so da die Struktur der Anleitung auch in HypTree sichtbar wird. 1.2 Release 2 gegenber Release 1 --------------------------------- Auch im Anhang knnen nun (sub)subnodes auftreten (brauchte ich fr diese Historie). Nun maximal 200 Eintrge im Anhang mglich. Bei der Wandlung nach ST-Guide erscheint die Titelangabe im In- haltsverzeichnis nur noch, wenn '!maketitle' vor '!tableofcontents' angegeben wurde. Per '!include' knnen weitere UDO-Files in eine Doku eingebun- den werden. Das Inhaltsverzeichnis wird dementsprechend berck- sichtigt. Man kann also z.B. typische Kapitel wie "Haftungsaus- schlu" in eine externe Datei auslagern und an passender Stelle "includen". Folgende Platzhalter (Metazeichen + Buchstabe) knnen benutzt werden und werden beim Umwandeln durch die bereits gemachten Angaben im Header des UDO-Files ersetzt: - !A: author - !C: arcname - !D: date - !E: email - !L: path - !P: program - !R: version (V ging nicht, da durch Effekt belegt) - !S: street - !T: town Eine Datei wird jetzt bis zu dreimal nacheinander gelesen, be- dingt durch die Einfhrung des '!include'-Kommandos. Beim ers- ten Mal werden die Doku-Infos (Name des Autors etc.) ermittelt, beim zweiten Mal die Kapitelnamen, und last but not least beim dritten Mal die Umwandlung des Textes vorgenommen. (unvollstndige) Kommandoreferenz im Anhang Vier neue Kommandos: - !=tex - !=asc - !=stg - !=1wp Im Gegensatz zu den quivalenten wird hier eine Zeile nur dann ausgegeben, wenn man nicht nach TeX, ASCII, ST-Guide oder 1st- Word wandelt. Die Optionen knnen nun auch grogeschrieben an UDO bergeben werden. COMMAND.TOS liefert laut Peter Klasen @ KR die Komman- dozeile in Groschrift, was dazu fhrt(e), da UDO eine Feh- lermeldung ausgab. Aufgrund der Platzhalter mute der Link-Befehl gendert werden! Innerhalb der Verweisangaben mu nun '|' statt des Ausrufezei- chens angegeben werden! Eine unfertige GEM-Version gibt's nun auch, die leider noch nicht sichern kann und Probleme mit dem Auffinden von Include-Da- teien hat, daher werde ich sie erst demnchst verffentlichen. Neues Kommando !shorttoc, welches dazu fhrt, da das Inhaltsver- zeichnis in einer kurzen Version ausgegeben wird. Neues Kommando !noheadlines, welches die Titelzeilen innerhalb von Nodes bei der ST-Guide-Ausgabe unterbindet. Bei \verb wird jetzt nicht mehr das Pipesymbol '|' benutzt, sondern ''. Dieses Zeichen drfte weniger Verwendung in TeX finden als das Pipesymbol. Kapitelnummern im Inhaltsverzeichnis sind jetzt auf zwei Stellen ausgerichtet. 1.3 Release 1 gegenber Private Release 7 ----------------------------------------- Metazeichen gewechselt (sorry!) in Kommandos mssen Leerzeichen nicht mehr durch das Metazeichen ersetzt werden Bei Effekten und weiteren Kommandos steht das Metazeichen jetzt innerhalb der Klammern UDO schaut nun, ob man eine gerade oder ungerade Anzahl an Anfh- rungszeichen gesetzt hat und entscheidet sich beim Wandeln nach TeX automatisch fr das passende. Die Anfhrungsstriche mssen nun doppelt angegeben werden, was schneller von der Hand geht als Metazeichen + Anfhrungsstrich. Rudimentre Umwandlungen nach 1stWord mglich (Leerzeichen, Effekte). Die beiden Kommandos (!grin) == ;-) bzw. \verb|;-)| (!laugh) == :-) bzw. \verb|:-)| eingebaut.