ver. 1.1.2
Copyright (c) Martin Jindra  ICQ status
Release: 2004-10-25

Tento program je vytvořen na základě nástroje vytvořeného Martinem Haluzou (mhaluza@eqeus.com).

Verze Jméno E-mail GUI Dokumentace
1.0e Martin Jindra martin.jindra@egservis.cz (2002-04-04) (2002-04-04)
1.0z Martin Jindra martin.jindra@egservis.cz (2002-12-20) (2002-12-20)
1.0h Martin Jindra martin.jindra@egservis.cz (--) (--)
1.0h SE Martin Jindra martin.jindra@egservis.cz (2003-05-21) (2003-05-21)
1.0h TH Martin Jindra martin.jindra@egservis.cz (2003-08-15) (2003-08-15)
1.01 Martin Jindra martin.jindra@egservis.cz (2003--) (2003--)

Obsah:

Děkuji za stáhnutí PDM.


Poděkování

Chtěl bych poděkovat všem, co testovali různé alfa, beta, gama, delta, epsilon verze a dali k dobru spoustu nápadů: Elmer Adkins, Martin Růžička, Milan Kosina, Nadya Nosonovsky, Pablo Rivera, Henry C. Dagher, Vlad Grynchyshyn, Václav Krs, Agnes Scheffler, Karas Zdeněk, Goldman Claude, Pavel Kouřil, Olga Vitengerová, Milan Kosina, Vašo Elias, Michal Tvrdý, Grigore Dolghin ...
Všem co provedli překlad do dalších jazyků: Martin Haluza, Jan Korecko, Lionel Sevestre, Marco Wotschadlo.

Závaznost (Liability)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


Cíl PDM

PDM slouží pro vytvoření kompletní HTML dokumentace vašeho VFP projektu (VFP 3.0 - VFP 7.0). Vytvořené HTML stránky jsou plně připraveny pro převod do formátu PDF či Post Script.
Výtváří se detailní popis:

Projektu
  • Základních vlastností
  • Vlasností EXE souboru
  • Ostatních vlastností
  • OLE public tříd
Dat
  • Volných tabulek (položky a indexy)
  • Dotazů (Definice SELECT SQL)
  • DBC konteinerů
    • Tabulek (položky, indexy a vlastnosti tabulky)
    • Pohledů (položky, indexy, definice SELECT SQL a další vlastnosti)
    • Spojení
    • Uložených procedur
    • Soubor událostí
VCX knihoven
  • Objektové hierarchie
Formulářů
  • Objektové hierarchie
  • DataEnvironmentu
Programů
  • Procedur/Funkcí
  • Tříd
  • Objektové hierarchie
Reportů
  • Vlastností reportu
  • Vlastností tiskárny
  • Proměnných
  • Bandů
  • Rychlého náhledu
  • Detailů všech objektů
  • DataEnvironmentu
Štítků
  • Vlastností štítku
  • Vlastností tiskárny
  • Proměnných
  • Bandů
  • Rychlého náhledu
  • Detailů všech objektů
  • DataEnvironmentu
Menu
  • Obecných vlastností
  • Rychlého náhledu
  • Detailů všech objektů
  • Analýza vloženého zdrojového kódu stejná jako u programů
Spřátelené projekty
  • Seznam pro rychlý přechod

Obecné funkce:

Jak používat tento software?

Spuťte PDM, zadejte umístění vašeho projektu (najděte .PJX souboru), a výstupní adresář a stiskněte tlačítko Zpracuj. PDM vytvoří sadu HTML stránek ve výstupním adresáři. Hlavní stránka může být Project.htm nebo jiná (záleží na tom, jaké části se generují). Další hlavní stránky jsou: Data.htm, Class.htm, Form.htm, Code.htm, Menus.htm, Reports.htm, Labels.htm a Other.htm.

Jestliže najdete nějakou chybu nebo máte nějakou otázku či návrh , prosím , kontaktuj te mě na adrese martin.jindra@egservis.cz. Jestliže chcete být informován(a) o nové verzi PDM, pošlete mi zprávu.

Jestliže vytvoříte nějakou modifikaci nebo verzi, prosím, oznamte mi to.


Hlavní okno a Dialogy

Hlavní okno
Spřátelené projety (spolupracující projekty)
Další nastavení
Seznam souborů na zpracování
Jeden nebo více souborů
Setup & Cleanup
Plug-ins
Komentáře
Přehled projektu
Uživatelské odkazy

Spouštění PDM

Parametry: GUI se spustí pokud:

Spuštění bez GUI

1) DO PDM WITH "myproj.pjx","c:\temp\myproj", "myproj.pdm"
V tomto případě se převezmou nastavení pro generování HTML dokumentace ze souboru myproj.pdm, ale generuje se dokumentace pro projekt myproj.pjx do adresáře c:\temp\myproj.
2) DO PDM WITH "","", "myproj.pdm"
V tomto případě se převezmou nastavení pro generování HTML dokumentace ze souboru myproj.pdm včetně zdrojového projektu a výstupního adresáře.
3) DO PDM WITH "myproj.pjx","c:\temp\myproj"
V tomto případě se generuje dokumentace pro projekt myproj.pjx do adresáře c:\temp\myproj dle základních nastavení.
4) DO PDM WITH "","","x:\test\xxa000.pdm,x:\test\xxa001.pdm"
V tomto případě se generuje dokumentace pro PDM projekty x:\test\xxa000.pdm ax:\test\xxa001.pdm . První dva parametry jsou vždy ignorovány.
5) DO PDM WITH "program1.prg,forms1.scx","c:\temp\myfiles", "myfiles.pdm"
V tomto případě se převezmou nastavení pro generování HTML dokumentace ze souboru myfiles.pdm, ale generuje se dokumentace pro soubory program1.prg,forms1.scx do adresáře c:\temp\myfiles.
6) DO PDM WITH "program1.prg,forms1.scx","c:\temp\myfiles", "myfiles.pdm", "",1
V tomto případě se převezmou nastavení pro generování HTML dokumentace ze souboru myfiles.pdm, ale generuje se dokumentace pro program1.prg,forms1.scx do adresáře c:\temp\myfiles přičemž se pro každý soubor vytváří vlastní adresář.

Spuštění s GUI - jazykové mutace

Cesta je buď relativní vzhledem k cestě, kde se nachází PDM.APP, nebo absolutní.
1) Spuštění GUI v Anglickém jazyce: DO PDM WITH "","","","lang\en"
2) Spuštění GUI v Českém jazyce: DO PDM WITH "","","","lang\cs"
3) Spuštění GUI v Slovenském jazyce: DO PDM WITH "","","","lang\sk"
4) Spuštění GUI v Ruském jazyce: DO PDM WITH "","","","lang\ru"
5) Spuštění GUI v Španělském jazyce: DO PDM WITH "","","","lang\es"
6) Spuštění GUI v Francouzském jazyce: DO PDM WITH "","","","lang\fr"
7) Spuštění GUI v Německém jazyce: DO PDM WITH "","","","lang\de"

Problémy

Při startu PDM se mohou objevit problémy. Hlášení jsou vždy v Anglickém jazyce.
Can't find directory of resource.
Adresář zdrojů pro generování HTML souborů neexistuje. Je to adresář RES.
Can't find FLL library %File%.
Potřebná FLL knihovna neexistuje. %File% je název FLL knihovny.
Can't find VCX library %File%.
Potřebná VCX knihovna neexistuje. %File% je název VCX knihovny.
Can't load FLL library %File%.
Nepodařilo se zavést potřebnou FLL knihovnu. %File% je název FLL knihovny. FLL knihovna může být poškozená, nebo chybějí či jsou poškozené knihovny RT MS VC++.
Can't load VCX library %File%.
Nepodařilo se zavést potřebnou VCX knihovnu. %File% je název VCX knihovny. VCX knihovna může být poškozena.
Directory %Dir% localized resource not exist.
Uvedený adresář, kde mají být umístěny lokalizované soubory neexistuje. %Dir% je název adresáře
Localized table %File% not exist.
Potřebná tabulka s lokalizovanými řetězci neexistuje. %File% je název tabulky.
Localized library %File% not exist.
Potřebná VCX knihovna s lokalizovanými formuláři neexistuje. %File% je název VCX knihovny.
Cannot open localized table %File%.
Nepodařilo se otevřít potřebnou tabulku s lokalizovanými řetězci. %File% je název tabulky.
Cannot open localized library %File%.
Nepodařilo se zavést potřebnou VCX knihovnu s lokalizovanými formuláři. %File% je název VCX knihovny.

Historie

PDM ver. 1.1.2

Opraveno:
- Po ukončení PDM spuštěného z IDE se neresetovala ikona hlavního okna VFP.
- Za určitých podmínek se netestovalo zda došlo ke změně.
- Pokud byl v přehledu projektu definován DOC soubor a podobně, pak uvedený sobor nebyl kopírován do složky "repository".
- Iživatelské odkazy; pokud mělk soubor definován protokol file:// a měl nastaveno kopírování do složky "repository", pak do uvedené složky nebyl kopírován.
- Po změně přípony pro skupinu (Další nastavení, Výchozí přípony), PDM ignorovalo toto nastavení.
- PDM nevytvářelo odkzay na objekty v VCX/SCX.
- Strom tříd pro třídy v VCX/PRG obsahoval nekorektní odkazy na třídy pokud byly všechny třídy generovány na jednu HTML stránku.
- Nastavení "Smazat výstupní složku" bylo ignorováno jestliže výstupní složka obsahovala soubory s aspoň jedním atributem RO nebo S nebo H.
- Chybová hláška "Alias loPDM not found." při zpracování třídy cursoradapter a její odvozenin.
- Nekorektní interní odkazy na PDM objekt na plug-inech.
- Špatná analyza zdrojových kódů s metadaty.
- Špatné xhtml pokud tabulka vlastností obsahovala jednu z uvedených vlastností MemberClass, MemberClassLibrary, atd.

PDM ver. 1.1.1

Nové:
- Plug-in DIAMP-PDM rozšířen o uložení metadat pro popis M/P v externí tabulce (struktura je shodná s tabulkou pro plug-in DIAP-PDM).
- Přidány plug-iny DIAMP_PDM_MD a DIAP_PDM_MD kde metadata je XML dokument.
- Přidána nová skupina plug-inů "Po vytvoření" a plug-iny pro HTMLDOC a HTML Help Workshop.
- Přidán plug-in typu EFRX pro Mind's Eye Report Engine.
- Přidán globální strom tříd a objektů za celý PDM projekt.
- Přidány křížové odkazy z tabulek a pohledů na třídy, formuláře, reporty a labely.
- Jako hlavní stránka se generuje soubor Index.htm.
- XHTML elementy img mají definován atribut alt.
- Přibyla možnost definovat velikost okraj stránky pro přímý tisk.
- Přibyla možnost definovat zda se do HTML mají zahrnout mezery a konce řádků.
- Přibyl dialog pro globální nastavení PDM.
- Přibyl dialog o aplikaci.
- Přepracován hlavní formulář GUI.
- Přidána možnost defiovat výchozí složku.
Opraveno:
- CSS styly pro plug-in DIAMP-PDM.
- Špátně generované odkazy na objekty v seznamu objektů.
- Špatná detekce objektů zdědených ze tříd na formuláři.
- Špatná detekce H souborů v projektu.
- Spousta malých chybiček.

PDM ver. 1.01

Nové:
- Přidán plug-in typu EFRX pro FRX2Any.
- Přidán plug-in typu EFRX pro eReports.
Změna:
- Odstraněn parametr SC_Type. Nyní je Syntax Coloring prováděn kombinací pomalé a rychlé metody.
- Plug-in typu EFRX pro XFRX detekuje všechny klíčová slova.
Opraveno:
- Matice označena jako Hidden vlastnost.
- Chyba v metodě QuickAnalyse().
- Chyba v metodě Analyse().
- Odstraněno zpomalení při přípravě projektu v předzpracování PRG a H souborů.
- Špatná detekce státu ve vlastnostech projektu.
- Nefukční odkazy na uložené procedury ve vlastnostech tabulky.
- Detekce TXT souborů jako H soubory pokud nebyly H soubory detekovány.
- Spousta drobných chyb v GUI.

PDM ver. 1.0h TH

Nové:
- Přidán plug-in typu DIAP.
- Přidán plug-in typu EFRX pro XFRX.
Opraveno:
- Opraveno generování seznamu položek pro pohledy.
- A spousta jiných drobných chyb.

PDM ver. 1.0h SE

Nové:
- Přidáno "Quick View menu".
- Přidáno "obecné vlastnosti menu".
- Přidána možnost definovat Setup & Cleanup.
- DIAMP (Detailní info o metodě/proceduře)
- Přidána možnost definovat plug-in pro DIAMP.
- Přidána možnost definovat vlastní komentáře použité ve zdrojovém kódu.
- Přidána detekce hlavičkových souborů a aktivní odkazy ve zdrojovém kódu.
- Přidána definice "Přehled projektu".
- Přidána možnost definovat "Uživatelské odkazy".
- U projektu lze definovat klíč pro indetifikaci souboru komentářů.

Opraveno:
- Opraveno generování stromu tříd.
- Opraveno generování Quick View reportu.
- Menší výstupní HTML kód.
- Zmatené hodnoty vlastností tříd a objektů.
- Drobné chyby při generování detailu objektů reportu a Quick View reportu.

PDM ver. 1.0h

Nové:
- Přibyla možnost generovat HTML dokumentaci pro jeden nebo více souborů bez nutnosti definování projektu.
- Přidáno SyntaxColoring pro indexové výrazy a klauzule FOR.
- Přidáno SyntaxColoring pro hodnoty vlastností definované jako výraz.

Opraveno:
- Opraveny chyby v metodě _pdm_DBC::GenerateHTML().
- Pokud bylo spuštěno PDM z menu nebo z jiného programu, pak se objevila hláška "Can't find directory of resources".

PDM ver. 1.0z2

Nové:
- Přibylo Francouzské GUI.
- Pro sloupce (A,H,P,NI) se generuje atribut "title" s příslušným textem (Array,Hidden,Protected,Not Init).

Opraveno:
- Opravena chyba v metodě _pdm_DBC::GenerateHTML_DBC().

PDM ver. 1.0z

Nové:
- V chybovém hlášení přibyla identifikace souboru, při jehož zpracování došlo k chybě.
- Obrázky uvedené v projektu se kopírují do repozitáře a generují se na ně odkazy.
- Obrázky uvedené ve vlastnostech objektů a tříd (Picture,DownPicture atd.) se kopírují do repozitáře a generují se na ně odkazy.
- Pod hlavním menu je náhled na obrázek.
- Ve vlastnostech objektu (třída cursor) se generuje odkaz na DBC konteiner nebo volnou tabulku.
- Má-li tabulka nastaveny triggery, pak se generují jejich odkazy do uložených procedur v databázi.
- Pro DBC konteiner se generuje příznak,zda jsou využívány Events (nutno rekompilovat projekt pod VFP 7.0).

Opraveno:
- Neukončené tagy IMG.
- Občas se generovala hodnota atributu href tagu <a> bez uvozovek.
- Pokud neexistoval soubor uvedený v projektu, pak byla hlášena chyba v metodě _pdm::ICL_TestFile().
- Občas byla hlášena chyba "Alias not found..." v metodách _pdm::Save_ICL() a _pdm::Read_ICL() při startu PDM, načtení a uložení souboru PDM.
- Odkazy v hlavních html stránkách obsahovaly znak \ místo /.
- Pokud byly u třídy ve VCX knihovně u ikon pro toolbar a konteiner uvedena pouze cesta, pak se generovaly neplatné odkazy na ikony.
- Pokud byl poslední řádek zdrojového kódu ukončen ";", pak byla hlášena chyba "Subscript is outside defined range." v _pdm_Analysesc.Analyse().
- Byla-li v volbě menu rychlá klávesa, pak nedošlo k nahrazení znaku < entitou.
- Byl-li program prost procedur,funkcí a metod, pak se negenerovaly elementy </body > a </html >.
- Generovaly se špatné odkazy pro volné tabulky a dotazy.
- Chyba "Invalid subscript reference." při generování detailu reportu/labelu.
- Chyba "Invalid subscript reference." po přidání či odebrání spřáteleného projektu a spuštění generování HTML dokumentace.
- Chyba "Variable'_PDM_MSGNCDIR' is not found" pokud nelze vytvořit výstupní adresář.

Změny:
- Stránky se generují v !DOCTYPE xhtml.
- Všechny texty vkládané do HTML jsou vyextrahovány to tabulky HTML.dbf.

PDM ver. 1.0e

Nové:
- GUI a HTML Dokumentace ve Slovenštině.
- Zpracování Menu.
- Generování seznamu Spřátelených projektů.
- Sbalit/Rozbalit všechny procedury programu nebo metody třídy/objektu.
- Generování stromu tříd u VCX/PRG/MNX souborů.
- Přibyla možnost výstupní adresář pro HTML dokumentaci před generováním vyčistit.
- Pro detail reportu, labelu a menu lze definovat šířku pravé části v procentech.
- V režimu GUI je možno přerušit vytváření HTML dokumentace pomocí klávesy Escape.
- Je možno provádět inkrementální generování dokumentace na úrovni souborů (s výjimkou volných tabulek a dotazů).
- Zahrnutí detailního popisu metod/procedur ze zdrojového kódu do výsledné dokumentace.
- Řízená dokumentace.

Opraveno:
- Titulek okna u hlavní stránky seznamu labelů.
- Pokud se nepodařilo otevřít Spřátelený projekt, pak došlo k sérii chyb.
- V české lokalizaci opraveny nepřeložené popisy na stránkách "Formuláře" a "Programy".
- Na stránkách "Reporty" a "Štítky" opraven popis jednoho checkboxu z "Ostatní vlastnosti bandů a objektů" na "Ostatní vlastnosti bandů a seznamu objektů"
- Ve vygenerovaných HTML souborech zmizely prázdné řádky po sbalených vlastnostech položek, bandů a seznamu objektů v bandu.
- Při ukládání se mohly špatně vygenerovat umístění Spřátelených projektů.
- Špatně vygenerovaný odkaz na rodičovskou třídu v definici třídy v PRG souboru.
- Špatně vygenerované odkazy na rodičovskou třídu v definici třídy v VCX/PRG/MNX souboru, pokud bylo nastaveno generování tříd na jednu stránku.
- Generování názvu obrázku pro repositář, pokud se shodovaly názvy, ale lišilo se umístění.
- Procedura Trim_SC() pro oddělení komentáře od zdrojového kódu.

Změny:
- Došlo ke změně generování struktury souborů do výstupního adresáře. Každý soubor má vlastní adresář v podadresáři dle skupiny příslušnosti.
- Na výběr výstupního adresáře se používá nový dialog.

PDM ver. 1.0d (2)

Změny:
- Nyní se tisknou HTML soubory až po jejich vygenerování.

Nové:
- Pomalé nebo rychlé parsování pro Syntax Coloring.
- HTML Dokumentace v Angličtině a Češtině.

Opraveno:
- Špatné relativní odkazy na soubory.
- Nesetříděný seznam souborů v PDMprn.log .
- Špatně strukturovaný formát HTML pro konverzi do PDF nebo jiných formátů.
- Adresáře pro VCX/SCX/PRG/FRX soubory nebyly malými písmeny.
- Člen dmOrientation zobrazoval špatný popis ve vlastnostech tiskárny v DEVMODE .
- Pokud selhalo zavedení FLL knihovny, pak došlo k chybě.

PDM ver. 1.0d (1)

Opraveno:
NOSONOV@email.msn.com (2002-03-26)
- I pressed View HTML doc and got "Not exist HTML main page." Not sure, what does it mean, and this phrase doesn't sound correct from the English grammar point of view.

- Buttons with pictures need a tooltip text, because otherwise it's not clear, what they do.

eadkins@worldnet.att.net (2002-03-29)
- Some of the Messagebox and UI elements are not in English.

eadkins@worldnet.att.net (2002-02-12)
- The View PDM LOG File and VIEW Error Log file Buttons do not seem to work. The PDM LOG file was empty, so I assume that it did not work because of this, however the error log file contained the following error, yet did not display it from the interface button. I found it in the resulting doc folder:
12 - _PDM_ANALYSESC2.REPAIROBJECTHIERARCHY - 159
Variable 'LCFILE' is not found. 8760

Note: If are write in PDM LOG file message: "Object %Obj% cannot be found in file %File%.:", then mean Error in method RepairObjectHierarchy() in class _PDM_ANALYSESC.

- Pokud bylo zpracování přerušeno, pak se neuzavřely všechny soubory otevřené pomocí metody FCreate().
- Pokud nebyl vytvořen APP/EXE/DLL a generovala se stránka PJX_Page.htm, pak došlo k chybě.
- Verze EXE souboru se generovala špatně.
- Nekorektní algoritmus v metodě RepairObjectHierarchy().
- Parameter lcOutDir v Go.prg se nekoretně přebíral.
- Nekorektní odkazy na jednotlivé stránky pro VCX knihovnu.