summaryrefslogtreecommitdiff
path: root/macros/generic/c_pascal/README.pol
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/generic/c_pascal/README.pol
Initial commit
Diffstat (limited to 'macros/generic/c_pascal/README.pol')
-rw-r--r--macros/generic/c_pascal/README.pol94
1 files changed, 94 insertions, 0 deletions
diff --git a/macros/generic/c_pascal/README.pol b/macros/generic/c_pascal/README.pol
new file mode 100644
index 0000000000..e86c9c47b9
--- /dev/null
+++ b/macros/generic/c_pascal/README.pol
@@ -0,0 +1,94 @@
+Polskie robaczki w standardzie ISO-Latin2.
+=======================================================================
+
+ CAP (C albo Pascal) --- makra do składu programów w C i Pascalu
+
+=======================================================================
+
+
+ Zawartość
+-----------
+Ten pakiet makr składa się z trzech plików:
+ cap_c.tex --- makra do składu programów w języku C
+ cap_pas.tex --- makra do składu programów w Pascalu
+ cap_comm.tex --- pomocnicze makra i deklaracje używane do składania
+ programów w obu językach; ten plik nie zawiera
+ żadnych makr pożytecznych dla użytkownika
+
+
+ Programy w C
+--------------
+W pliku cap_c.tex znajdują się definicje dwóch makr:
+
+ 1. \BeginC ... \EndC
+ Pomiędzy te komendy należy wstawić dowolny program źródłowy
+ w języku C. Treść programu zostanie sformatowana z wykorzystaniem
+ odpowiednich czcionek. Rozpoznawane są następujące elementy
+ programu:
+ * słowa kluczowe --- domyślnie wyróżniane są pogrubieniem
+ * teksty --- wszystko to, co wewnątrz apostrofów; domyślnie pochylone
+ * komentarze --- zarówno /*takie...*/ jak i //takie... ,
+ ale nie zagnieżdżone; kursywa typewriter
+ * symbole --- operatory, nawiasy, itp.; typewriter
+ * dyrektywy kompilatora --- składane pochyloną czcionką typewriter
+ * identyfikatory --- wszystko, co nie jest żadnym z powyższych;
+ kursywa
+ Makro nie ingeruje w układ programu. Wcięcia są pozostawione takie,
+ jakie są w programie źródłowym. Podział na linie również nie jest
+ zmieniany.
+ UWAGA: W trakcie kompilacji makro \BeginC ... \EndC wczytuje cały
+ program do pamięci TeXa. Z tego powodu można spodziewać się kłopotów
+ składając tym makrem bardzo duży program. W mojej konfiguracji
+ (emTeX pod DOSem) wszystko działa bez zarzutu jeśli program jest
+ nie większy niż około 15KB. Jeśli NAPRAWDĘ konieczne jest wstawnienie
+ ogromnego programu bezpośrednio do pliku TeXowego, konieczny będzie
+ podział programu na mniejsze części, z których każda będzie ujęta
+ w komendy \BeginC ... \EndC.
+
+ 2. \InputC{nazwapliku}
+ Wstawia program w języku C z pliku zewnętrznego. Program zostanie
+ sformatowany jak w poprzednim przypadku. Przypomnienie dla pracujących
+ pod DOSem: w nazwie pliku wszystkie wtyłciachy należy zastąpić
+ ciachami.
+ To makro nie nakłada ŻADNYCH ograniczeń na rozmiar programu --- czyta
+ wskazany plik linia po linii, więc nie grozi mu wyczerpanie pamięci.
+
+Lista słów kluczowych znajduje się w pliku cap_c.tex. Nie gwarantuję, że
+jest kompletna, więc w razie potrzeby można ją poprawić.
+
+
+ Programy w Pascalu
+--------------------
+Aby składać programy w Pascalu należy załączyć plik cap_pas.tex. Zawiera
+on również dwa makra:
+
+ 1. \BeginPascal ... \EndPascal
+
+ 2. \InputPascal{nazwapliku}
+
+Działają one analogicznie. W przypadku \BeginPascal ... \EndPascal
+obowiązują podobne ograniczenia na wielkość formatowanego programu.
+W programie rozpoznawane są zarówno {takie} jak i (*takie*) komentarze.
+
+Lista słów kluczowych pochodzi z Pomocy Borland Delphi. W razie potrzeby
+można ją zmodyfikować.
+
+
+ Wspólne
+---------
+Czcionki używane do składania programów są zadeklarowane na początku
+pliku cap_comm.tex. W razie potrzeby można je łatwo przedefiniować.
+Osoby używające czcionek PL zamiast CM będą musiały zmodyfikować dwie
+linie w tym pliku. Są one wyraźnie zaznaczone.
+
+
+ Uwaga
+-------
+Jeśli modyfikujesz któryś z plików, zaznacz wyraźnie swoje zmiany. Nie
+chcę brać odpowiedzialności na modyfikacje wprowadzone przez innych.
+
+
+------------
+
+ Michał Gulczyński
+ mgulcz@we.tuniv.szczecin.pl