lkml.org 
[lkml]   [2009]   [May]   [13]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    /
    Date
    SubjectRe: [PATCH]man-pages : section 9 for kernel api description.
    From
    Thank you for your opinion.

    2009/5/13 Américo Wang <xiyou.wangcong@gmail.com>:
    > On Wed, May 13, 2009 at 11:04:28AM +0900, GeunSik Lim wrote:
    >>
    >>
    >>Dear Michael Kerrisk,
    >>
    >>Are you maintainer of man-pages(man-pages-3.XX.tar.gz)?
    >>I am not sure...
    >
    > Yes, he is.
    >
    >>
    >>I use fedora 9 distribution as Linux based Desktop OS currently.
    >>I have one proposal about "#> man <linux-kernel-api>" command.
    >>Can you tell me your opinion about below patch?
    >>Thanks reading.
    >>
    >>commit 45e950c98412c002c47254507a199731315c7c2b
    >>Author: GeunSik,Lim <leemgs1@gmail.com>
    >>Date:   Wed May 13 10:49:47 2009 +0900
    >>
    >>    Append Section 9 info of man command.
    >>
    >>    We view description of the Linux kernel API with man command.
    >>       For example,
    >>       Fedoar9#> yum install kernel-doc*
    >>       Fedora9#> man kobject_rename  or
    >>       Fedora9#> man kthread_create
    >
    > Why?
    > Why do you want kernel api doc be in man pages?
    > Why not just browsing the kernel source code?
    >
    I want Michael to append patch file in the man-pages source that I
    sent because
    Many linux distributions (ex: Fedora , openSUSE, and so on ) already
    support kernel api for man currently.
    In general, kernel api(ex:kernel-doc-2.6.29.1-30.fc10.noarch.rpm) is
    located in the
    /usr/share/man/man9/ directory when we installed linux distribution
    like Fedora by default.
    So, I think that we need description and section 9 folder(man9) in the
    man-pages source
    to understand meaning of man 9.


    > Kernel APIs are not stable at all, this is also a reason why you
    > should not include their doc into man pages.
    I agree that Kernel APIs is not stable.
    But, I believe that we can utilize "#> man <linux-kernel-api>" command
    in the own
    Linux distribution easy to use about "uname -a" Linux kernel version.
    This support is a valuable. I think that The problem deserves solving.

    Thanks reading.

    >
    > --
    > Live like a child, think like the god.
    >
    >



    --
    Regards,
    GeunSik Lim
    --
    To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
    the body of a message to majordomo@vger.kernel.org
    More majordomo info at http://vger.kernel.org/majordomo-info.html
    Please read the FAQ at http://www.tux.org/lkml/
    --
    To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
    the body of a message to majordomo@vger.kernel.org
    More majordomo info at http://vger.kernel.org/majordomo-info.html
    Please read the FAQ at http://www.tux.org/lkml/

    \
     
     \ /
      Last update: 2009-05-13 17:09    [W:0.024 / U:0.208 seconds]
    ©2003-2016 Jasper Spaans. hosted at Digital OceanAdvertise on this site