autogen - Online în cloud

PROGRAM:

NUME

autogen - Generatorul automat de programe

REZUMAT

autogen [-steaguri] [-steag [valoare,--opțiune-nume[[=| ]valoare]] [ ]

AutoGen creează fișiere text din șabloane folosind definiții externe.

DESCRIERE

AutoGen este conceput pentru a genera fișiere de program care conțin text repetitiv cu variate
substituiri. Scopul este de a simplifica întreținerea programelor care conțin mari dimensiuni
cantități de text repetitiv. Acest lucru este deosebit de valoros dacă există mai multe blocuri de
un astfel de text care trebuie menținut sincronizat.

Un exemplu comun este problema menținerii codului necesar procesării programului
Opțiuni. Opțiunile de procesare necesită păstrarea a cel puțin patru constructe diferite
ordinea corectă în diferite locuri din programul dvs. Ai nevoie de cel puțin: Caracterul steag
în șirul de steag, cod pentru procesarea steagului atunci când este întâlnit, o stare globală
variabilă sau două și o linie în textul de utilizare. Veți avea nevoie de mai multe lucruri în afară de aceasta dacă
alegeți să implementați nume lungi de opțiuni, procesare fișier de configurare, mediu
variabile și așa mai departe.

Toate acestea se pot face mecanic; cu șabloanele adecvate și acest program.

OPŢIUNI

următor Opțiuni selecta definiții, şabloane și schemă funcții la utilizare
-L dir, --templ-dirs=dir
Căutați șabloane în DIR. Această opțiune poate apărea de un număr nelimitat de ori.

Adăugați un director la lista de directoare autogen căutări la deschiderea a
șablon, fie ca șablon principal, fie ca unul inclus. Ultima intrare are
cea mai mare prioritate în lista de căutare. Adică sunt căutați înăuntru
ordine inversă.

-T fișier tpl, --override-tpl=fișier tpl
Utilizare TPL-FIȘIER pentru șablon. Este posibil ca această opțiune să nu fie presetată în funcție de mediu
variabile sau în fișiere de inițializare (rc).

Fișierele de definiție specifică șablonul standard care urmează să fie extins. Această opțiune
va suprascrie numele respectiv și va extinde un alt șablon.

-l fișier tpl, --lib-template=fișier tpl
Încărcați macrocomenzi AutoGen de la TPL-FIȘIER. Această opțiune poate apărea un număr nelimitat de
ori.

Macrocomenzile DEFINE sunt salvate din acest fișier șablon pentru a fi utilizate la procesarea principalului
fișier macro. Textul șablonului, în afară de macrocomenzile DEFINE, este ignorat.

Nu utilizați acest lucru. În schimb, utilizați macrocomandă INCLUDE în șablon.

NOTĂ: ACEST OPȚIUNE IS DEPRECAT

--definiții=fişier, Fl -fără definiții
Citiți definiții din FILE. fără definiții formularul va dezactiva opțiunea. Acest
opțiunea este activată implicit. Este posibil ca această opțiune să nu fie presetată în funcție de mediu
variabile sau în fișiere de inițializare (rc).

Utilizați acest argument pentru a specifica fișierul de definiții de intrare cu o opțiune de linie de comandă.
Dacă nu specificați această opțiune, atunci trebuie să existe un argument în linia de comandă care
specifică fișierul, chiar dacă doar pentru a specifica stdin cu o cratimă (-). Specifica,
--fără-definiții când doriți să procesați un șablon fără AutoGen activ
definiții.

--coajă=coajă
numele sau calea numelui shell-ului de utilizat.

În mod implicit, atunci când AutoGen este construit, configurația este testată pentru o valoare rezonabilă
Shell asemănător Bourne de utilizat pentru procesarea scriptului shell. Dacă un anumit șablon
are nevoie de un shell alternativ, acesta trebuie specificat cu această opțiune în comandă
linie, cu o variabilă de mediu (COAJĂ) sau în configurație/inițializare
fișier.

-m, --no-fmemopen
Nu utilizați fluxuri in-mem.

Dacă biblioteca locală C acceptă „fopencookie(3GNU)", sau"funopen(3BSD)" atunci
AutoGen preferă să folosească buffer-ul de flux în memorie deschis în loc de fișiere anonime.
Acest lucru poate duce la probleme dacă există o lipsă de memorie virtuală. Dacă, pentru a
anumită aplicație, rămâneți fără memorie, apoi specificați această opțiune. Aceasta este
puțin probabil într-un mediu modern de memorie virtuală pe 64 de biți.

Pe platformele fără aceste funcții, opțiunea este acceptată, dar ignorată.
fmemopen(POSIX) nu este adecvat deoarece buffer-ul său de șir nu este realocat.
open_memstream(POSIX) is de asemenea nu este adecvat deoarece pârâul este deschis doar pentru
ieșire. AutoGen are nevoie de un buffer realocabil disponibil atât pentru citire, cât și pentru
scris.

--echivala=char-list
caractere considerate echivalente. Implicit char-list pentru această opțiune este:
_-^

Această opțiune va modifica lista de caractere considerate echivalente. Implicit
sunt cele trei caractere, „_-^”. (Ultimul este convențional pe un Tandem/HP-NonStop,
și obișnuiam să lucrez mult la Tandems.)

următor Opțiuni modifica cum producție is manipulate
-b nume, --nume-bază=nume
Specifica NUME ca nume de bază pentru ieșire. Este posibil ca această opțiune să nu fie presetată
variabilele de mediu sau în fișierele de inițializare (rc).

Un șablon poate specifica numele exact al fișierului de ieșire. În mod normal, nu.
În schimb, numele este compus din numele de bază al fișierului de definiții cu
sufixe anexate. Această opțiune va înlocui numele de bază derivat din
nume de fișier de definiții. Acest lucru este necesar dacă nu există un fișier de definiții și
recomandabil dacă definițiile sunt citite din stdin. Dacă definiţiile sunt fiind
citit din standard în, numele de bază este implicit stdin. Orice director principal
componentele din nume vor fi eliminate silențios. Dacă doriți ca fișierul de ieșire să
apar într-un anume director, se recomandă să „cd” în acel director
directorul mai întâi sau utilizați nume de directoare în specificația formatului pentru ieșire
liste de sufixe, vezi: pseudo macro.

--sursa-timp, - Fl -fără-sursă-timp
setați orele mod la cea mai recentă sursă. The timp fără sursă formularul va dezactiva opțiunea.

Dacă ștampilați fișierele de ieșire cu ID ieșire macro, apoi fișiere de ieșire
va fi întotdeauna diferit, chiar dacă conținutul nu s-a schimbat cu adevărat. Dacă utilizați
această opțiune, atunci timpul de modificare a fișierelor de ieșire se va schimba numai dacă
se modifică fișierele de intrare. Acest lucru va ajuta la reducerea construcțiilor inutile.

--inscriptibil, - Fl -ne-scris
Permiteți fișierelor de ieșire să poată fi scrise. The ne-inscriptibil formularul va dezactiva opțiunea.

Această opțiune va lăsa fișierele de ieșire inscriptibile. În mod normal, fișierele de ieșire sunt citite-
numai.

următor Opțiuni sunt de multe ori util în timp ce depanare nou şabloane
Acestea specifică limite care împiedică șablonul să dureze prea mult sau să producă mai mult
ieșire decât se aștepta.

--limită-buclă=lim
Limitarea buclelor de increment. Această opțiune ia un număr întreg ca argument.
Valoarea a lim este constrâns să fie:
exact -1 sau
în intervalul de la 1 la 0x1000000
Valoarea implicită lim pentru această opțiune este:
256

Această opțiune previne buclele evaporate. De exemplu, dacă specificați din greșeală „PENTRU
x (pentru-de la 1) (pentru-la -1) (pentru-de la 1)", va dura mult timp până la finalizare. Dacă
dacă aveți mai mult de 256 de intrări în tabele, va trebui să specificați o nouă limită cu
această opțiune.

-t secunde, --pauză=secunde
Limitați operațiunile serverului la SECUNDE. Această opțiune ia un număr întreg ca
argumentul său. Valoarea a secunde este constrâns să fie:
în intervalul de la 0 la 3600

AutoGen funcționează cu un proces de server shell. Majoritatea comenzilor normale se vor finaliza în
mai puțin de 10 secunde. Dacă, totuși, comenzile dvs. au nevoie de mai mult timp decât acesta, utilizați
această opțiune.

Intervalul valid este de la 0 la 3600 de secunde (1 oră). Zero va dezactiva ora serverului
limită.

--urmă=nivel
urmărirea nivelului de detaliu. Această opțiune ia un cuvânt cheie ca argument. The
argumentul stabilește o valoare de enumerare care poate fi testată comparându-le cu
macrocomanda valorii opțiunii. Cuvintele cheie disponibile sunt:
nimic debug-message server-shell
şabloane bloc-macro-expresii
tot
sau echivalentul lor numeric.

Valoarea implicită nivel pentru această opțiune este:
nimic

Această opțiune va face ca AutoGen să afișeze o urmă a procesării șablonului său.
Există șase niveluri, fiecare nivel incluzând mesaje de la nivelurile anterioare:

nimic Nu face deloc urmărire (implicit)

mesaj de depanare Imprimați mesajele din macro-ul AutoGen „DEBUG” (vezi: DEBUG).

server-shell Urmează toate intrările și ieșirile către shell-ul serverului. Aceasta include a
Scriptul de inițializare „independent” de shell cu o lungime de aproximativ 30 de linii. Ieșirea sa este
aruncate și nu introduse în niciun șablon.

şabloane Urmează invocarea lui DEFINId macro-uri și INCLUDEs

macro-bloc Urmează toate macrocomenzile bloc. Cele de mai sus, plus IF, PENTRU, CASE și IN TIMP CE.

expresii Afișează rezultatele evaluărilor expresiilor.

tot Afișează invocarea fiecărei macrocomandări AutoGen, chiar și TEXT macrocomenzi (de ex
textul din afara ghilimelelor macro). În plus, dacă reconstruiți ``expr.ini''
fișier cu depanarea activată, apoi toate apelurile la funcțiile de schemă definite AutoGen
va fi și logat:
cd ${top_builddir}/agen5
DEBUG_ENABLED=bash adevărat bootstrap.dir expr.ini
face CFLAGS='-g -DDEBUG_ENABLED=1'

Fiți conștienți de faptul că nu puteți reconstrui această sursă în acest fel fără a avea mai întâi
instalat autogen executabil în calea dvs. de căutare. Din această cauză, „expr.ini”
este în lista de surse distribuite și nu în dependențe.

--trace-out=fişier
urmărirea fișierului de ieșire sau a filtrului.

Ieșirea specificată poate fi un nume de fișier, un fișier care este atașat la sau, dacă
argumentul opțiunii începe cu ţeavă operator (|), o comandă care va primi
urmărirea ieșirii ca standard în. De exemplu, --traceout='| Mai puțin' va rula urma
ieșire prin intermediul mai puțin program. Adăugarea la un fișier este specificată înainte de
nume de fișier cu două caractere mai mari decât (>>).

--show-defs
Afișați arborele de definiții. Este posibil ca această opțiune să nu fie presetată cu variabile de mediu
sau în fișierele de inițializare (rc).

Aceasta va tipări arborele complet de definiții înainte de procesarea șablonului.

--utilizat-definește
Arată definițiile folosite. Este posibil ca această opțiune să nu fie presetată în funcție de mediu
variabile sau în fișiere de inițializare (rc).

Aceasta va tipări numele valorilor de definiție căutate în timpul
procesarea șablonului, indiferent dacă a fost găsit sau nu. Pot fi altele
definiții de referință într-un șablon în porțiuni ale șablonului neevaluate.
Unele dintre numele enumerate pot fi nume calculate, iar altele pot fi argumente macro AutoGen.
Acesta nu este un mijloc de a produce o listă definitivă, atotcuprinzătoare a tuturor și
numai valorile utilizate dintr-un fișier de definiție. Acesta este destinat ca un ajutor pentru
doar documentația șablon.

-C, --miez
Lăsați un depozit de miez la o ieșire de eșec.

Multe sisteme implicit la o limită de bază de dimensiune zero. Dacă sistemul are
antet sys/resource.h și dacă această opțiune este furnizată, atunci în eșec ieșire
cale, autogen va încerca să stabilească limita nucleului moale la orice nucleu dur
limita este. Dacă acest lucru nu funcționează, atunci un administrator trebuie să ridice nucleul dur
limita de dimensiune. în fișierele de definiții și fișierele șablon” Ele precizează care
ieșiri și părți din ieșiri de produs.

-s sufix, --sări-sufix=sufix
Sari peste fișierul cu asta SUFIX. Această opțiune poate apărea un număr nelimitat de
ori. Este posibil ca această opțiune să nu fie presetată cu variabile de mediu sau în
fișiere de inițializare (rc). Această opțiune nu trebuie să apară în combinație cu niciuna dintre
următoarele opțiuni: select-sufix.

Ocazional, poate să nu fie de dorit să se producă toate fișierele de ieșire specificate
în șablon. (De exemplu, numai .h fișier antet, dar nu .c program
text.) Pentru a face acest lucru specificați --skip-sufix=c pe linia de comandă.

-o sufix, --selectare-sufix=sufix
specificați acest sufix de ieșire. Această opțiune poate apărea de un număr nelimitat de ori.
Este posibil ca această opțiune să nu fie presetată cu variabile de mediu sau în inițializare (rc)
fișiere.

Dacă doriți să înlocuiți specificațiile sufixului din șablon, puteți utiliza unul
sau mai multe copii ale acestei opțiuni. Consultați specificația sufixului în @ref{pseudo
macro} secțiunea din documentul de informații.

-D valoare, --defini=valoare
nume de adăugat la lista de definiții. Această opțiune poate apărea un număr nelimitat de
ori.

Numele definite AutoGen sunt utilizate în următoarele scopuri:

Secțiunile definițiilor AutoGen pot fi activate sau dezactivate utilizând stilul C
Directivele #ifdef și #ifndef.

Când definiți o valoare pentru un nume, puteți specifica indexul pentru o anumită valoare.
Acest index poate fi o valoare literală, o opțiune define sau o valoare #define-d în
definițiile în sine.

Numele unui fișier poate fi prefixat cu $NAME/. $NAME parte a șirului de nume
va fi înlocuită cu valoarea definită-d pentru NUME.

Când AutoGen a terminat de încărcat definițiile, valorile definite sunt exportate
la mediu cu, putenv(3). Aceste valori pot fi apoi utilizate în scripturile shell
cu ${NAME@} referințe și în șabloane cu (getenv "NUME").

În timpul procesării unui șablon, puteți specifica un index pentru a prelua o anumită valoare.
Acest indice poate fi, de asemenea, o valoare definită.

Este complet echivalent să plasați acest nume în mediul exportat.
Pe plan intern, asta face de fapt AutoGen cu această opțiune.

-U nume-pat, --nedefinit=nume-pat
model de eliminare a listei de definiții. Această opțiune poate apărea un număr nelimitat de
ori. Este posibil ca această opțiune să nu fie presetată cu variabile de mediu sau în
fișiere de inițializare (rc).

Similar cu „C”, folosește AutoGen #ifdef/#ifndef directive de preprocesare. Această opțiune
va determina eliminarea numelor care se potrivesc din lista de valori definite.

Acest opțiune is utilizat la automatizarea dependenţă de urmărire
-M tip, --face-dep [tip]
emite fișier de dependență make. Această opțiune poate apărea de un număr nelimitat de ori.
Este posibil ca această opțiune să nu fie presetată cu variabile de mediu sau în inițializare (rc)
fișiere.

Această opțiune se comportă destul de aproape de modul în care -M o serie de opțiuni cu care funcționează
compilatorul gcc, cu excepția faptului că în loc să emită doar predecesorul
dependențe, aceasta emite și dependențele succesoare (fișiere țintă de ieșire). De
implicit, informațiile de dependență de ieșire vor fi plasate .d, dar mai
fi de asemenea specificat cu -MF. Marca temporală a acestui fișier va fi manipulată
astfel încât să fie cu o secundă mai vechi decât cel mai vechi fișier de ieșire primar.

Ținta din acest fișier de dependență va fi în mod normal numele fișierului de dependență, dar
poate fi, de asemenea, suprascris cu -MT. AutoGen nu va modifica conținutul
acel fișier, dar îl poate crea și va ajusta timpul de modificare pentru a se potrivi
ora de începere.

NB: aceste a doua litere fac parte din argumentul opțiunii, deci -MF trebuie să aibă
caracterul de spațiu citat sau omis și -M "F " este acceptabil deoarece
F face parte din argumentul opțiunii.

-M poate fi urmată de oricare dintre literele M, F, P, T, Q, D sau G. Cu toate acestea, numai F,
Q, T și P sunt semnificative. Toate, cu excepția F, au semnificații oarecum diferite. -MT
este interpretat ca sens este un fișier santinelă care va depinde de toate intrările
(șabloane și fișiere de definiție) și toate fișierele de ieșire vor depinde de asta
dosar santinelă. Este potrivit pentru utilizare ca o țintă reală. Q este tratat
identic cu T, cu excepția caracterelor dolar („$”) sunt dublate. P provoacă o specială
regula falsă curată (clobber) pentru a fi inserată în fragmentul de fișier make. Un gol
regula este întotdeauna creată pentru construirea listei de ținte.

Aceasta este utilizarea recomandată:
-MForice-ți place.dep -MTyour-fișier-santinela -MP
și apoi în dvs makefile, Fă autogen regulă:
-include orice-ți place.dep
clean_targets += curățați-vă-fișierul-sentinel
.sp
fișierul-sentinel-dvs:
autogen -MT$@@ -MF$*.d .....
.sp
curat local:
rm -f $(ținte_curate)

Timpul de modificare a fișierului de dependență este ajustat să fie cu o secundă înainte
cea mai veche ștampilă de timp a oricărui alt fișier de ieșire. În consecință, este potrivit pentru
utilizați ca fișier sentinelă care să ateste faptul că programul a fost rulat cu succes.
(-include este modul GNU de a specifica „include-l dacă există”. Marca ta
trebuie să accepte această caracteristică sau procesul de bootstrap trebuie să creeze fișierul.)

Toate acestea pot fi specificate și folosind DEPENDENCE_OUTPUT or AUTOGEN_MAKE_DEP
variabile de mediu. Dacă sunt definite, vor fi scoase informații despre dependență. Dacă
definit cu spații albe text liber care este altceva decât adevărat, fals, da,
Nu., 0 or 1, atunci șirul este considerat un nume de fișier de ieșire. Dacă conține a
șir de caractere cu spațiu alb, primul simbol este ca mai sus și al doilea simbol
este considerat a fi fișierul țintă (sentinelă) ca -MT în paragrafele de mai sus.
DEPENDENCE_OUTPUT va fi ignorat dacă există mai multe secvențe de spațiu alb
caractere sau dacă conținutul acestuia este, în special, fals, Nu. or 0.

Ajutor, versiune și opțiune manipulare
-?, --Ajutor
Afișează informațiile de utilizare și ieși.

-!, --mai mult ajutor
Transmiteți informațiile de utilizare extinse printr-un pager.

-> [cfgfile], --save-opts [=cfgfile]
Salvați starea opțiunii în cfgfile. Valoarea implicită este ultimul Fișier de configurare
enumerate în OPȚIUNE PRESETS secțiunea, mai jos. Comanda va ieși după actualizare
fișierul de configurare.

-< cfgfile, --load-opts=cfgfile, --no-load-opts
Încărcați opțiuni de la cfgfile. opțiuni fără încărcare formularul va dezactiva încărcarea
fișierele config/rc/ini anterioare. --no-load-opts este tratat devreme, nefuncțional.

-v [{v|c|n --versiune [{v|c|n}]}]
Ieșiți versiunea programului și ieșiți. Modul implicit este `v', o versiune simplă.
Modul „c” va tipări informații despre drepturile de autor, iar „n” va tipări toate drepturile de autor
înștiințare.

OPȚIUNE PRESETS

Orice opțiune care nu este marcată ca nu presetabile pot fi presetate prin încărcarea valorilor de la
fișiere de configurare ("RC" sau ".INI") și valori din variabilele de mediu numite:
AUTOGEN_ or AUTOGEN
Presetările de mediu au prioritate (sunt procesate mai târziu decât) configurației
fișiere. homerc fișierele sunt "$ ACASĂ", și ".„. Dacă oricare dintre acestea sunt directoare, atunci
fişier .autogenrc este căutat în acele directoare.

MEDIUL

Vedea OPȚIUNE PRESETS pentru variabilele de mediu de configurare.

Utilizați autogen online folosind serviciile onworks.net