Ben belgeleyen kod tabanı tüm dosyaları her zaman ben phpDocumentor, tüm dosyalar için belirtilen ya da değil olursa olsun, eğer (aynı sürümünü kullanmak için tek bir yerde belirli bir yolu var mı aynı sürümünü "dize" kullanacak gerektiği otomatik miras)
... Ve ne diğer etiketler bu başınızın üst kapalı için yararlı olacaktır?
Edit:
Ebeveyn-çocuk ilişkileri etrafında alabilir şey var mı? Sürümü, yazar, telif hakkı okumak için. Ini veya yapılandırma dosyası gibi bir şey mi?
Ben phpDocumentor böyle bir şey veriyor farkında değilim.
Ayrıca, tüm dosyaları aynı sürümünü sahip yanlış kullanım gibi geliyor bana. Versiyon açıklama belirli bir dosya için bir versiyonunu sunuyor. Eğer, A sınıfı bir hatayı düzeltmek için niye Sınıf B değişim sürümü? Olsaydı
Birden fazla belgede aynı açıklamaları ekleme gelince, ben senin IDE çiftleşmiş özelliği içine bakmak öneririz. Genellikle, bu gibi parçacıkları yapılandırmak ve klavye kısayolları veya yeni dosyalar oluşturma onları ekleyebilirsiniz.
Başka bir seçenek Phing veya Ant ya da kod havuzunda bir pre-commit kanca aracılığıyla gibi bir açılma komut dosyası aracılığıyla belgeleri, oluştururken açıklamalar değerlerini ayarlamak ve değiştirmek olacaktır.
EDIT geçiyor phpdocumentor manual yine, ben buldum:
{@ Inheritdoc} inline etiketi sınıfları, yöntemleri ve çocuk sınıfların sınıf değişkenlerinin bilgilendirme kısmı kullanılır. phpDocumentor otomatik olarak bir üst sınıftan @ yazar etiketi, @ sürüm etiketi ve @ telif hakkı etiketi devralır. Hiçbir belgelerine comment mevcut varsa ek olarak, bu ebeveynin belgelerine devralır.
{@ Inheritdoc} satır içi etiket mevcut değildir ve bir çocuğun sınıf belgesiz ise, çocuğun sınıf hala gibi üst sınıf belgelere miras dener unutmayın. {@} Inheritdoc bir çocuğun sınıfın belgelerinde ana sınıfından belgeleri koymak nerede esneklik sağlar.
Bu sizin için ne arıyorsanız tam olarak değil, ama benzer bir yönü var.
