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

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

    <bug>
          <bug_id>17927</bug_id>
          
          <creation_ts>2008-11-18 11:15:43 +0300</creation_ts>
          <short_desc>Требуется документация</short_desc>
          <delta_ts>2016-11-18 18:27:39 +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>libshell</component>
          <version>unstable</version>
          <rep_platform>all</rep_platform>
          <op_sys>Linux</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Vladimir V. Kamarzin">vvk</reporter>
          <assigned_to name="Alexey Gladkov">legion</assigned_to>
          <cc>dottedmag</cc>
    
    <cc>erthad</cc>
    
    <cc>glebfm</cc>
    
    <cc>legion</cc>
          
          <qa_contact>qa-sisyphus</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>81268</commentid>
    <comment_count>0</comment_count>
    <who name="Vladimir V. Kamarzin">vvk</who>
    <bug_when>2008-11-18 11:15:43 +0300</bug_when>
    <thetext>Самодокументированность исходного кода это конечно хорошо, но нужно хотя бы какое-то overview функций, краткий справочник.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81277</commentid>
    <comment_count>1</comment_count>
    <who name="Alexey Gladkov">legion</who>
    <bug_when>2008-11-18 13:55:55 +0300</bug_when>
    <thetext>Какого рода документация нужна ? man-страницы (как для glibc) ?
Как я понимаю, будет не достаточно вынести описания функций.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81282</commentid>
    <comment_count>2</comment_count>
    <who name="Vladimir V. Kamarzin">vvk</who>
    <bug_when>2008-11-18 15:08:21 +0300</bug_when>
    <thetext>В долгосрочной перспективе - man-ы на английском. Дополнительно можно сделать статью на wiki на русском.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81283</commentid>
    <comment_count>3</comment_count>
    <who name="Mikhail Gusarov">dottedmag</who>
    <bug_when>2008-11-18 15:12:06 +0300</bug_when>
    <thetext>При наличии нормальных манов, на wiki нужны только проектные страницы на двух языках, с описанием, что такое libshell и где его репозиторий, для майнтайнеров других дистрибутивов - без этого те же sisyphus-mirror, mkimage или gear опакетить нормально нельзя.

Такое я сделать могу в любой момент.
</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81284</commentid>
    <comment_count>4</comment_count>
    <who name="Alexey Gladkov">legion</who>
    <bug_when>2008-11-18 15:15:29 +0300</bug_when>
    <thetext>(In reply to comment #2)
&gt; В долгосрочной перспективе - man-ы на английском.

Постараюсь сделать. Давно про это думал, но как-то из-за нескольких функций руки не доходили. Но раз вы просите, значит настал момент собраться и сделать.

&gt; Дополнительно можно сделать статью на wiki на русском.

Увольте-с.
</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81312</commentid>
    <comment_count>5</comment_count>
    <who name="Mikhail Gusarov">dottedmag</who>
    <bug_when>2008-11-19 15:43:45 +0300</bug_when>
    <thetext>На вики:

http://www.altlinux.org/libshell
http://en.altlinux.org/libshell

Больше ничего особенно и не нужно.
</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81315</commentid>
    <comment_count>6</comment_count>
    <who name="Alexey Gladkov">legion</who>
    <bug_when>2008-11-19 16:16:09 +0300</bug_when>
    <thetext>(In reply to comment #5)
&gt; Больше ничего особенно и не нужно.
 
Говорите за себя.

Это не документация. Такую &quot;документацию&quot; я мог бы написать, чтобы ничего не делать.
</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81316</commentid>
    <comment_count>7</comment_count>
    <who name="Mikhail Gusarov">dottedmag</who>
    <bug_when>2008-11-19 16:19:25 +0300</bug_when>
    <thetext>&gt; &gt; Больше ничего особенно и не нужно.
&gt; Говорите за себя.

На wiki больше ничего не нужно.
 
&gt; Это не документация.

Это проектные страницы.
</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>160008</commentid>
    <comment_count>8</comment_count>
    <who name="Repository Robot">repository-robot</who>
    <bug_when>2016-11-18 18:27:39 +0300</bug_when>
    <thetext>libshell-0.4.2-alt1 -&gt; sisyphus:

* Fri Nov 18 2016 Alexey Gladkov &lt;legion@altlinux&gt; 0.4.2-alt1
- New version (0.4.2).
- Add more docs (ALT#17927).
- New utilities:
  + shell-terminfo to simplify work with terminfo.
  + cgrep utility.
- shell-getopt changes:
  + Fix encoding in comment.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>