<?xml version="1.0" encoding="UTF-8" ?>

<bugzilla version="5.2"
          urlbase="https://bugzilla.altlinux.org/"
          
          maintainer="jenya@basealt.ru"
>

    <bug>
          <bug_id>17911</bug_id>
          
          <creation_ts>2008-11-17 09:23:52 +0300</creation_ts>
          <short_desc>FR: build docs and package separately</short_desc>
          <delta_ts>2018-04-18 09:45:40 +0300</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>4</classification_id>
          <classification>Development</classification>
          <product>Sisyphus</product>
          <component>mono-nunit22</component>
          <version>unstable</version>
          <rep_platform>all</rep_platform>
          <op_sys>Linux</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>WONTFIX</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>minor</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="ildar">ildar</reporter>
          <assigned_to name="ildar">ildar</assigned_to>
          <cc>at</cc>
    
    <cc>shaba</cc>
    
    <cc>sin</cc>
    
    <cc>vvk</cc>
          
          <qa_contact>qa-sisyphus</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>81179</commentid>
    <comment_count>0</comment_count>
    <who name="ildar">ildar</who>
    <bug_when>2008-11-17 09:23:52 +0300</bug_when>
    <thetext>Хорошо было бы иметь справочник NUnit, который генерится из кода. Формат monodoc.
Кроме того, код nunit довольно хорошо документирован.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81193</commentid>
    <comment_count>1</comment_count>
    <who name="Alexey Shabalin">shaba</who>
    <bug_when>2008-11-17 14:29:10 +0300</bug_when>
    <thetext>ок.
Ещё постараюсь сделать nunit-2.4.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81326</commentid>
    <comment_count>2</comment_count>
    <who name="Alexey Shabalin">shaba</who>
    <bug_when>2008-11-19 17:42:33 +0300</bug_when>
    <thetext>просто пакет с html документацией я сделаю. А вот в формате monodoc нет. Если раскажете как её сделать в этом формате - тогда сделаю.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81367</commentid>
    <comment_count>3</comment_count>
    <who name="ildar">ildar</who>
    <bug_when>2008-11-20 07:33:38 +0300</bug_when>
    <thetext>man mdoc. Конкретного рецепта у меня нет, с наскоку я ман не одолел. Если пока трудно, можно начать с html (не закрывая бага), поменяв на FR</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81371</commentid>
    <comment_count>4</comment_count>
    <who name="Alexey Shabalin">shaba</who>
    <bug_when>2008-11-20 12:22:59 +0300</bug_when>
    <thetext>mono-nunit22-2.2.10-alt2 с подпакетом doc в сизифе.
Дай знать, когда придумаешь как зделать доку в формате monodoc. Аналогичные пакеты ещё есть. Кроме этого, ещё есть пакеты использующие mono-ndoc. Конечно хорошобы всю документацию иметь единую в monodoc.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>98821</commentid>
    <comment_count>5</comment_count>
    <who name="ildar">ildar</who>
    <bug_when>2009-09-11 00:51:09 +0400</bug_when>
    <thetext>(В ответ на комментарий №4)
&gt; Дай знать, когда придумаешь как сделать доку в формате monodoc. Аналогичные пакеты ещё есть.

Оказалось всё довольно нетрудно.
1. mcs -doc:/tmp/incode.docs.xml *.cs
    создаёт файл xml с документацией
2. mdoc-update -i /tmp/incode.docs.xml /usr/lib/mono/1.0/nunit.core.interfaces.dll --out .
    создаёт (или обновляет) документацию на DLL с учётом того xml, который был создан ранее.

Глядя в сам NUnit, я не нашёл цели для NAnt Build, чтобы создать документацию. ИМХО надо связаться с апстримом, чтобы они добавили. Я, пожалуй, могу этим заняться (или ты займись).
Пока же можно прохакать файлы *.build, чтобы параллельно с компиляцией, создавался (или создавались) файл документации xml.
Справишься?

&gt; Кроме этого, ещё есть пакеты использующие mono-ndoc. Конечно
&gt; хорошо бы всю документацию иметь единую в monodoc.

я посмотрю ndoc. А ты, пожалуйста, уточни: какие пакеты используют ndoc-доки.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>106661</commentid>
    <comment_count>6</comment_count>
    <who name="ildar">ildar</who>
    <bug_when>2010-02-13 13:38:33 +0300</bug_when>
    <thetext>http://sourceforge.net/tracker/?func=detail&amp;atid=360749&amp;aid=2857669&amp;group_id=10749

Апстрим молчит, поэтому закрываю с LATER</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>