Thread overview
DDoc işleminde istenmeyen modüller
May 10, 2018
zafer
May 11, 2018
zafer
May 10, 2018

Merhaba, ddoc ile doküman oluştururken istemediğim modülleri nasıl devre dışı bırakabilirim? Örneğin aşağıdaki dosyada bulunan 'import vibe.d;' modülünün dokümantasyona eklenmesini istemiyorum.

import vibe.d;   // Bu modül dokümantasyona dahil olmasın.
import std.stdio;

/**
* Authors: Hasip Hesapçıoğlu
*
* Bugs: Sıfırla bölmeye karşı vs. denetim yoktur.
*/
struct Hesapçı {
   int bölen;    /// Bu, 'bölen'in belgesidir

   /**
    * Verilen değerin bölünmüşünü döndürür
    *
    * Params:
    *    değer = Bölünecek değer
    *
    * Returns: Bölme işleminin sonucu
    */
   int böl(int değer) {
       return değer / bölen;
   }
}

/// Ddoc açıklaması bulunan 'unittest' blokları da belgeye dahil edilir.
unittest {
   auto h = Hesapçı(2);
   assert(h.böl(42) == 21);
}

void main()
{
	writeln("Edit source/app.d to start your project.");
}

--
[ Bu gönderi, http://ddili.org/forum'dan dönüştürülmüştür. ]

May 10, 2018

Ben denediğimde onlar dokümantasyona eklenmiyor. (?) Gördüğüm kadarıyla, derleyici yine de kodun derlenebilir olmasını gerektiriyor. O yüzden vibe.d'nin yerinin -I ile gösterilmiş olması gerekiyor.

Yanılmıyorsam, private olarak işaretlenen tanımlar dokümantasyona eklenmez.

Ali

--
[ Bu gönderi, http://ddili.org/forum'dan dönüştürülmüştür. ]

May 11, 2018

Evet haklısın. Vibe dosyalarının yolunu bir türlü gösteremedim. Bende kendim birkaç ayrı modül oluşturarak denedim ve söyledğin gibi modülleri sadece derlemek için kullanıyor çıktıya eklemiyor.

dub build -b docs

Dub içinde 'docs' komutunu buldum ancak bu tüm modüllerin dökümanını çıkarıyor. Bununla ilgili bir bilgin var mı?

--
[ Bu gönderi, http://ddili.org/forum'dan dönüştürülmüştür. ]

May 11, 2018

Bir kaç kere kullanmış olmak dışında dub'da deneyimim veya uzmanlığım yok. :/

Ali

--
[ Bu gönderi, http://ddili.org/forum'dan dönüştürülmüştür. ]