adabrowse - Bulutta Çevrimiçi

Program:

ADI

adabrowse - Ada 95 spesifikasyonlarının tam olarak çapraz referanslı HTML işlemesini oluşturun

SİNOPSİS

göz atmak [seçenekler] -f dosya

TANIM

göz atmak Ada 95 özelliklerinin tam çapraz referanslı bir HTML işlemesini üretir (gövdesiz)
javadoc'un Java kaynakları için yaptığına benzer. göz atmak bir komut satırı yardımcı programıdır; sahip
grafiksel kullanıcı arayüzü yok.

göz atmak komut satırı seçenekleri, stil sayfaları aracılığıyla yüksek düzeyde yapılandırılabilir ve
yapılandırma dosyaları

göz atmak kaynak kodunu tamamen ayırır ve bir HTML belgesi oluşturur
kapsamak:
· Tüm bağlam maddeleri
· Birim başlığı
· Birim bir paket ise:
- Tüm istisnalar (yeniden adlandırmalar dahil)
— Tüm sabitler
— Tüm değişkenler
- Tüm türleri ve ilkel işlemlerini içeren bir tür dizini (yalnızca ikincisi
(etiketli) kayıt türleri, özel türler ve bunlardan türetilen türler için). bu
ilkel işlemler listesi tamamen çapraz referanslıdır ve yeni tanımlanmış,
geçersiz kılınan ve devralınan işlemler.
- Diğer öğeler

KULLANIM

kullanmanın iki yolu vardır göz atmak:

1. Telefon etmek göz atmak spec için: göz atmak -f dosya (ve gerektiğinde diğer seçenekler,
belirli -I dosya geçerli dizinde değilse veya diğer birimlere bağlıysa
kaynakları geçerli dizinde olmayanlar!) Verilen birim için ağaç dosyası yoksa
, mevcut göz atmak bir tane üretmeye çalışacak.

or

1. Aramak suretiyle işlemek istediğiniz teknik özellikler için ağaç dosyalarını oluşturun. gnagcc -c -gnatc
-saçma dosya (uygun olan -I Seçenekler, gerekirse.)

2. Telefon etmek göz atmak bu özellikler için: göz atmak -f dosya (ve gerektiğinde diğer seçenekler
[özellikle şuna bakın -T!]).

göz atmak geçerli dizinde varsayılan olarak HTML dosyaları oluşturur.

göz atmak ağaç dosyalarının özelliklerden mi yoksa gövdelerden mi üretildiği umrunda değil:
Bir gövdenin ağaç dosyası her zaman spesifikasyonla ilgili bilgileri de içerdiğinden,
ya ile çalışın.

SEÇENEKLER

-h, -?, -Yardım, --yardım et
Kapsamlı bir yardım metni yazar.

-a, -herşey, --herşey
Yalnızca -f seçeneğinde verilen birim için değil, aynı zamanda tümü için HTML oluşturun
anlamsal olarak bağlı olduğu uygulama birimleri ("with" es'in geçişli kapanışı
ve ana birimler).

Bu seçeneğin yalnızca geçişli durumdaki uygulama birimlerini işlediğini unutmayın.
"-g" seçeneği de verilmiş olsa bile kapatma; herhangi bir "ile" ed işlemez
standart kütüphane birimi. Bu aynı zamanda, verilen birim standart bir kitaplık ise
birim, "-all" seçeneğinin hiçbir etkisi yoktur. Bu davranış kasıtlıdır:
normalde tüm standartları işleyerek standart kitaplık için bir kez HTML oluşturur
açık bir şekilde kitaplık birimleri ve bu birimler için HTML'yi yeniden oluşturmak istemiyorsunuz
her seferinde uygulama biriminizden biri standart bir kitaplık birimi "ile".

-c dosya
HTML oluşturucu için bir yapılandırma dosyası tanımlar. çoklu -c seçenekler olabilir
verilen; dosyalar verilen sırayla işlenir ve önceki yapılandırmanın üzerine yazabilir
ayarlar.

-f dosya
İşlenecek spesifikasyonun dosya adını (*.ads) verir. Bu dosya adı bir
yol! Daha fazla yorum için aşağıya bakın. Sadece bir -f seçenek verilebilir.

-g ayarlanırsa, göz atmak içindeki kütüphane birimlerinden öğelere çapraz referanslar da oluşturur.
örtük paketteki öğeler hariç standart ve çalışma zamanı paketleri
"Standart". Not: Bu, bir yapılandırma dosyası anahtarıyla da ayarlanabilir.
"Refs_To_Standard". Son tanım kazanır.

-G çıktı_formatları...
Çıktı biçimlerini belirtin göz atmak üretecektir. bu -G seçenek izlenmeli
ayrı bağımsız değişkenler olarak verilen bir veya daha fazla çıktı biçimi adıyla. Tanınan çıktı
biçim adları html ve xml (büyük/küçük harfe duyarsız).

-i [dosya]
ayarlanırsa, göz atmak "dosya giriş modunda" çalışırsa bir paket dizini oluşturur
(aşağıya bakınız) veya -herşey seçenek ayarlanır ve çıktı stdout'a gitmez.

Bir dosya adı verilmişse, dizin o dosyaya (veya stdout'a,
dosya adı "-").

-dır-dir [dosya]
-i ile aynıdır, ancak alt birimler için girinti kullanarak bir dizin oluşturur.

-l Yapmak göz atmak Yalnızca satır numarasını kullanarak HTML çıktısında çapraz referanslar oluşturun.
Bu, önceki sürümlerin göz atmak (V2.13'e kadar ve dahil) her zaman yaptı.
V3.0'dan itibaren, çapraz referanslar hem çizgi hem de
bir öğenin sütun numarası. Bu seçeneği yalnızca HTML'niz varsa kullanmalısınız.
daha önce oluşturulan belgeler göz atmak sürümleri ve bir şekilde yeniden olamaz
bu belgeleri oluşturun. Ancak, önerilen kullanım bunu asla kullanmamaktır.
seçeneği ve muhtemelen zaten var olan HTML belgelerini yeniden oluşturmak için.

HTML ile oluşturulan unutmayın -l olmadan oluşturulan HTML ile uyumlu değil -l!
Ayrıca, HTML tarafından oluşturulan göz atmak 3.0 ve üstü, oluşturulan HTML ile uyumludur
by göz atmak 2.13 ve öncesi, yalnızca -l seçenek verilir.

Bu seçeneğin kullanımı stderr üzerinde bir uyarı mesajı oluşturur.

-o [dosya]
Çıktı dosyası adını tanımlayın. Ayarlanmadıysa, çıktı adındaki bir dosyaya gider.
giriş ve sonek . Html. Eğer dosya bir dizini belirtir (yani, üzerinde "\" ile biter)
Windows veya Unix'te bir "/"), oluşturulan tüm HTML dosyaları buna konulacak
dizin. Dosya adı "-" ise çıktı stdout'a yazılır. Sadece bir -o seçenek
verilebilir.

Dosya adı ("-") olarak yalnızca bir çıktı biçimi varsa izin verilir
belirtildi. Belirtilen birden çok çıktı biçimi varsa (örneğin, hem XML hem de HTML),
çıktının stdout'a gitmesine izin verilmiyor.

-p [dosya]
As -i, ancak işlenen tüm birimler üzerinde bir alt program dizini oluşturur.

-özel, --özel
verilirse, göz atmak paketlerin ve görevin özel kısımlarını da işleyecek veya
korumalı beyanlar (Varsayılan olarak bunu yapmaz, ancak özel
"Uygulama tanımlandı" diyen bir yorumla bölümler.)

-q Sessiz mod: uyarı veya bilgi mesajları vermeyin. eş anlamlısı -w0.

-s URL Oluşturulan HTML dosyasının kullanacağı stil sayfasının URL'sini tanımlar. Bu URL
HTML dosyalarını koyacağınız son yere göre olmalıdır! Bunu not et
a -s seçeneğin üzerine daha sonra yazılabilir -c seçenek, eğer yapılandırma dosyası
"Style_Sheet" anahtarını tanımlar.

-t [dosya]
As -i, ancak işlenen tüm birimler üzerinde genel bir tür dizini oluşturur.

-version, --versiyon
Sürüm bilgilerini yazdır göz atmak stderr'e.

-wi uyarı seviyesini ayarlar göz atmak. i aşağıdakilerden biri olabilir:
0 veya e yalnızca hata mesajlarını yazdırır.
1 veya w uyarıları ve hataları yazdırır.
2 veya i veya tüm mesajları yazdır.

-x ayarlanırsa, göz atmak asla mevcut HTML dosyalarının üzerine yazmaz. (Yararlı olabilir
ile birlikte -a seçeneği.)

-X isim=değer
Bir ortam değişkeni tanımlayın isim değeri olan değer. Değer herhangi birinin yerini alır
muhtemelen zaten mevcut tanımı isim Bunun için sistem ortamında
seslenmek göz atmak. Yeni tanım, işlenen tüm yapılandırma dosyalarını etkiler.
daha sonra ve ayrıca proje dosyası (varsa). bu isim beyaz içermemelidir
uzay; Eğer değer boşluk içeriyor, tüm tanımı -X"user=John'daki gibi alıntılayın
Doe" arasında beyaz boşluk olabilir veya olmayabilir. -X ve değişken
tanım.

-I rehber
ASIS için kaynak yolları tanımlayın. TBMM ile aynı semantik. çoklu -I seçenekler olabilir
verilecek.

-T rehber
ASIS'in ağaç dosyalarını (*.adt) araması için yolları tanımlayın. çoklu -T seçenekler olabilir
Verilen.

Bir dosya adı verirseniz şunu unutmayın: -i "s" harfiyle başlayan seçenek,
seçenek ile dosya adı arasında bir boşluk bırakmalısınız, aksi takdirde
olarak tanınmak -dır-dir seçenek. Ayrıca, dosya adı "-" ile başlıyorsa,
seçenek ve dosya adı arasında herhangi bir boşluk olabilir, çünkü varsa, göz atmak
dosya adını bir sonraki seçenek olarak kabul edecek ve bu şekilde ele alacaktır (seçeneklerin tümü
"-" ile başlayın, dosya adı olarak değil.

Aynı uyarı aşağıdakiler için de geçerlidir: -p seçeneği, alt program dizininin
"rivate" adlı bir dosyaya gidin: bir boşluk olmalıdır, aksi takdirde her şey
olarak tanınmak -özel seçenek. (Kuşkusuz bu oldukça patolojik bir
durumda, ancak burada tam olması için bahsedildi.)

L' -f SEÇENEK

The -f seçeneğin üç farklı biçimi vardır:

1. Dosya adı "-" veya "@-" ise, göz atmak işlenecek birimlerin birim özelliklerini okur
stdin'den, hat başına bir birim, EOF ile karşılaşılıncaya kadar. Boş satırlar atlanır. (Eğer
Bunu etkileşimli olarak denerseniz, EOF'yi kendiniz işaret etmeniz gerekir. Aksi takdirde, bu olabilir
girdi, "ls -1 *.ads | adabrowse -f-..." gibi bir kanaldan geliyorsa kullanışlıdır.)

2. Dosya adı "@" ile başlıyorsa, göz atmak bunu bir birim özelliği olarak görmez, ancak
Her satırda bir birim olacak şekilde birim adlarının okunacağı metin dosyasının adı. boş satırlar
dosyada yoksayılır.

3. İkisi de geçerli değilse, göz atmak birim özelliği olarak verilen dosya adını kullanır.

İlk iki durum, "dosya giriş modu" olarak adlandırılır. göz atmak. Dosya şunları içerebilir:
boş satırlar ve yorumlar (bir satırdaki ilk "#" ile başlayan ve sonuna kadar uzanan)
satırın sonu), yoksayılır. Yapılandırma dosyalarının aksine, dizenin
yorum başlangıçlarını bulma işlemi yapılmadı ve satır devamları da yapılmadı
izin verdi.

Her üç durumda da birim belirtimi, bir yol içerebilen bir dosya adıdır; olası bir sonek
göz ardı edilir. Birim özelliğinin bir dosya adı olduğuna dikkat edin; başka bir deyişle, veriyorsun test genya da
test-gen.ads, ve yok Test.Gen. Bunun nedeni, çoğu kabuk komut dosyası için
dillerde, dosya adlarıyla çalışmak, onları birim adlarına (örn.
tireleri noktalarla değiştirerek). Ayrıca, krunched dosya adlarınız varsa, basit bir işlem yoktur.
dosya adı ve birim adı arasındaki bağlantı.

Bir birim özelliği bir yol içeriyorsa, o birimin HTML dosyası o dizine yerleştirilir.
tarafından geçersiz kılınmadıkça -o seçenek. Birim spesifikasyonu bir yol içeriyorsa, en çok
muhtemelen bir de ayarlamak zorunda -T or -I ASIS'e sahip değilseniz
doğrudan mevcut bilgiler (yani, geçerli dizindeki birim için bir ağaç dosyası;
ama bu tam olarak tipik değil).

Dosya giriş modunda, -o seçeneği (eğer verilmişse) "-" olabilir (bu durumda tüm
çıktı stdout'a gider) veya bir dizin belirtin, ancak bir dosya belirtmemelidir.

göz atmak kaynak ve HTML dosyaları için TBMM'ye benzer bir adlandırma şeması olduğunu varsayar. Ayrıca varsayar
dosya başına bir kitaplık birimi olduğunu. V1.4'ten itibaren, göz atmak krunched dosyayı işleyebilir
içindeki isimler -f seçeneği, bir kaynak dosya bulabilmesi ve uzantısına sahip olması koşuluyla .reklamlar.
Eğer öyleyse, göz atmak yerine birim adını çıkarmak için kaynak dosyayı açar ve ayrıştırır.
doğrudan dosya adından türetilir. Oluşturulan dosyaların her zaman temelli adlara sahip olduğunu unutmayın.
orijinal dosya adında değil, birim adında: yani, çıktı dosyası adları asla
çatlamış.

Oluşturulan HTML dosyaları her zaman ".html" son ekine sahiptir (".htm" değil).

INDEX ÜRETİMİ

Dizin oluşturma şu durumlarda etkindir: göz atmak birkaç birimi işlemesi söylenir ve çıktı
stdout'a gitmiyor (ne zaman -o seçeneği verilmiştir).

Dizin oluşturmayı kontrol eden birkaç seçenek vardır:

-i or -dır-dir Bir birim endeksinin oluşturulmasını açar.
-p Bir alt program indeksinin oluşturulmasını açar.
-t Bir tür indeksinin oluşturulmasını açar.

Tüm bu seçenekler, parametre olarak isteğe bağlı bir dosya adı alır. Bir dosya adı takip ediyorsa,
index o dosyaya (veya dosya adı "-" ise stdout'a) yazılacaktır. Eğer
dosya adı verilmez, bazı varsayılan adlar seçilir.

Tüm bu seçenekler aslında yalnızca geriye dönük uyumluluk nedenleriyle korunur. itibariyle
V4.0, dizinler, komutta değil, öncelikle yapılandırma dosyası girişleriyle tanımlanır
astar. Önceki komut satırı seçeneklerini kullanarak mevcut komut dosyalarını bozmamak için
göz atmak sürümlerde, bu seçenekler hala kullanılabilir.

göz atmak aşağıdaki durumlarda birkaç birimi işleyeceğini varsayar:
· Dosya giriş modunda (-f @dosya adı or -F-).
· Bir proje dosyası kullanırken (-P proje_dosya_adı).
· Ne zaman -herşey seçenek verilir.

Dosya adı verilmemişse veya bir yol içermiyorsa, bu, ayarına bağlıdır.
dizinin yerleştirileceği diğer seçenekler:
· Dosya giriş modunda, eğer bir -o seçeneği verildiğinde, bir dizin belirtmelidir. Tüm HTML
dizin de dahil olmak üzere dosyalar bu dizine konacaktır.
· Eğer hayırsa -o seçenek verilir, ancak ilk birim özelliği bir yol içerir, dizin konur
bu yol tarafından belirlenen dizine.
· Dosya giriş modunda değilse, ancak -all seçeneği verilmişse, -o seçenek olabilir
bir dosya adı belirtin. Dizin, yol bölümü tarafından belirtilen dizine yerleştirilir.
bu dosya adının (dosya adı bir yol içermiyorsa geçerli dizin).
· Proje dosyası kullanılıyorsa, indeksler ADABROWSE_OUTPUT dizinine yazılır.
· Aksi takdirde, bu dizin geçerli dizine konur.

Bir yol içeren bir dosya adı verilirse, dizin o dosyanın içine yerleştirilecektir.
verilen dizin. Dosya adı yalnızca bir yol içeriyorsa, göz atmak bu yolu kullanacak ve
belirtilen dizinde "index.html" adlı bir dizin oluşturun.

Eğer bir -x seçenek verilmiş (mevcut HTML dosyalarının üzerine yazılmasını engelleyen) ve bir dosya var
zaten olduğu yerde göz atmak dizini koymak istiyor, dizin oluşturulmayacak
ve göz atmak uyarı verecektir. Ayrıca herhangi bir dizin oluşturamazsa uyarır.
diğer nedenlerle, ancak aksi takdirde işlemeye devam edecektir.

onworks.net hizmetlerini kullanarak adabrowse çevrimiçi kullanın