Ghidul utilizatorului CSMACRO
=============================
Programul este un mic procesor de texte, utilizabil din linia de comanda,pentru substituirea 
unor simboluri intr-un fisier ASCII, cu cele stabilite prin fisierele de configurare. 
In functie de extensia fisierului tinta (in care se vor efectua substitutiile) programul va 
folosi fisierele de substitutii (definitii):
- pentru fisiere sursa C/C++ avand extensia c, cpp, h - fisierul cmacro.txt
- pentru fisiere sursa Java, avand extensia java - fisierul jmacro.txt
- pentru scripturi SQL - fisierul sqlmacro.txt
- pentru fisiere avand alte extensii - fisierul macro.txt.
Bineinteles, acesta este comportamentul implicit al programului, putandu-se forta folosirea
oricarui fisier.
Sintaxa comenzii: 
	csmacro [fisier_definitii] fisier_sursa
Daca nu se transmite parametrul fisier_definitii, programul va alege valorile implicite
enumerate mai sus.
Definirea perechilor simbol <-> valoare de substituit se face simplu, de exemplu, fie
fisierul de definitii urmator:
# exemplu.txt
exe exemplu
datat doar atat
sex System.exit
Folosirea comenzii cu acest fisier de definitii, va avea ca rezultat substituirea fiecarei
aparitii a simbolului "exe" cu "exemplu", "datat" cu "doar atat" si a lui "sex" cu "System.exit".
Simbolurile din fisierul de sursa trebuie sa fie delimitate de caractere din urmatoarea
lista: spatiu(blank);,.[]{}()+-=/*.
Numarul de definitii dintr-un fisier de definitii este limitat la 200, lungimea unui simbol este limitata la 16 caractere, iar a valorii(sirului de caractere) de substitutie la 128 de caractere.
In fisierul de definitii se pot introduce comentarii folosind simbolul # (trecut pe prima 
pozitie in randul respectiv, fara spatiu inainte).
Programul a fost testat cu editoarele Crimson Editor, ConText Editor si JCreator Lite (lansat
din editoarele respective).

Exemplu - integrarea utilitarului csmacro in editorul Crimson Editor 3.70:
---------------------------------------------------------------------------
Editorul Crimson Editor, vers. 3.70 este freeware - Copyright (C) 1999-2004 Ingyu Kang. All rights reserved.

Din meniul Tools se alege optiunea Conf.User Tools...
In lista User Tools se alege o intrare nefolosita (empty) si se completeaza campurile astfel:
 Menu Text:   - numele sub care sa apara optiunea (lansarea csmacro) in meniul Tools
 Command:     - csmacro.exe
 Argument:    - $(FilePath)
 Initial Dir: - directorul in care aveti copiat utilitarul (e.g. C:\CSMacro\ ).
 Hotkey:      - dupa ce ati pozitionat cursorul pe acest camp, apasati combinatia de taste care
                vreti sa lanseze utilitarul.
Dupa dorinta, puteti seta si optiunile Save before execute (va salva documentul active inainte de
lansarea csmacro) si Capture output (va afisa mesajele utilitarului csmacro).
Dupa ce ati salvat aceste setari, folosind combinatia de taste ce ati stabilit-o, puteti utiliza
utilitarul.
Dupa utilizarea csmacro va trebui sa reincarcati fisierul (optiunea Reload din meniul File, sau Reload Document din meniul Document) pentru a lucra in continuare cu fisierul modificat/procesat.

Programul poate fi folosit si distribuit liber (freeware).
Autorul nu-si asuma nici o responsabilitate pentru functionarea corespunzatoare a programului,
sau pentru eventualele daune ce le-ar putea provoca.
Eventualele sugestii, comentarii pot fi trimise la adresa: amate2@email.ro.
2005.9.16.
(c) Mate Albert, 2005.