From Fedora Project Wiki

(added BC thesis: Manual pages)
Line 53: Line 53:
* [[SIGs/PowerManagement/RHEL5xF12comparison]]
* [[SIGs/PowerManagement/RHEL5xF12comparison]]
* http://people.redhat.com/~jskala/bltk/
* http://people.redhat.com/~jskala/bltk/
== BC thesis: Manual pages ==
=== CZ: Manuálové stránky ===
man formát je standadní formát používaný pro vytváření dokumentace v prostředí GNU Linux. Takzvané man stránky se vytváří ručně, pomocí GUI editorů, nebo s využitím utilit jako pod2man, které prochází zdrojový kód programů a do výsledné man stránky sestavují speciálně formátované komentáře.Cílem této práce by bylo:
# vytvořit přehledný návod jak psát manuálové stránky
#* přehled sekcí manuálových stránek a jejich význam
#* přehled nejpoužívanějších tagů (včetně tabulek)
#* popis doporučeného formátování (standardní odsazení, do které části co patří a jiné konkrétní tipy)
#* napsat několik ukázkových manuálových stránek k existujicim nástrojům/systémovým voláním/... a nechat si je uznat man-pages projektem
# přehled manuálových stránek
#* kolik jich je v man-pages, kolik celkem v které distribuci, jak se měnilo jejich množství v čase
#* porovnání množství manuálových stránek přeložených do různých jazyků
#* vytvořit distribučně (například pro Fedora 10, 11, 12, Debian 5.0, 4.0) nezávyslý skript(y), který by zobrazil:
#** množství manuálových stránek v dané distribuci celkem nebo jen pro danou sadu balíků
#** počet manuálových stránek podle sekce
#** zastoupení jednotlivých nástrojů použitých k jejich tvorbě
#** zastoupení tagů formátovacího jazyka manuálových stránek
#* vytvořit webové rozhraní kde by bylo možné zjistit informace per man-page (poslední aktualizace, ...) nebo per distribuce
# přehled nástrojů pro vytváření a převod do a z tohoto formátu
#* jaké jsou možnosti automatického generování dokumentace ze zdrojových kódů a které balíky je používají
# přehled dalších formátů dokumentace - info a jiné
# přehled projektů, které se zabývají překladem manuálových stránek do různých jazyků
=== Sources of information ===
* http://is.muni.cz/th/207575/fi_b/
$ man man
$ man groff
$ man roff

Revision as of 08:14, 27 October 2009

Jan Hutař

jhutar@redhat.com

Red Hat Czech - QA engineer

Inasnum - Fedora package sanity checker

See: https://fedorahosted.org/inasnum

rpmfluff

rpmfluff is a lightweight way of building RPMs, and sabotaging them so they are broken in controlled ways.

It is intended for use when testing RPM-testers e.g. rpmlint and writing test cases for RPM tools e.g. yum

See: https://fedorahosted.org/rpmfluff

BC thesis: Measure power consumption on a different Linux versions

CZ: Měření spotřeby energie na různých verzích Linuxu

Na různých verzích Linuxu (konkrétně distribuce Fedora) nainstalujte program (BLTK) simulující reálnou zátěž systému a pomocí watmetru opakovaně změřte spotřebu elektrické energie při jeho běhu. Měření opakujte na rozdílných strojích s rozdílnou HW konfigurací.

BLTK funguje pouze na Fedoře 11, proto budou potřeba opravy, které jej umožní spustit i na dalších měřených verzích této distribuce OS Linux.

EN: Measure power consumption on a different Linux versions

On various versions of Linux operation systems, known as Linux distributions, and considering Fedora Linux in particular, install package which simulates the real system stress (BLTK). Using the wattmeter measure the power consumption of the computer. Repeat the measure on computers with different hardware configurations.

BLTK is for now usable only for Fedora 11, so the part of this work is to adapt it for another versions of operating systems.

Ideas for additional tasks

  • measure BLTK run on older Fedoras (say, F9 - F12)
  • measure BLTK run on some different distros (Debian)
  • measure BLTK run with tuned enabled
    • are there tuned profiles already implemented?
  • measure BLTK run under plain X server without window manager, tons of tray icons and so on
  • prepare patches to tuned
    • is there any TODO document?
  • prepare patches for BLTK
    • e.g. to get it working on a older Fedora or different distro
    • is there any TODO document?
  • create set of C source files demonstrating GCC improvements over time
  • publish something on root.cz or abclinuxu.cz
    • ideas?
  • Red Hat internal small presentation about the work progress/goals/results
  • add some ethernet or wifi intensive test to the BLTK (or create a standalone script)
    • to simulate downloading big amounts of data
    • combined with chatting on IRC (low network usage)
  • find out how to lower wattmeter deviation
  • measure on a different HW

Sources of information


BC thesis: Manual pages

CZ: Manuálové stránky

man formát je standadní formát používaný pro vytváření dokumentace v prostředí GNU Linux. Takzvané man stránky se vytváří ručně, pomocí GUI editorů, nebo s využitím utilit jako pod2man, které prochází zdrojový kód programů a do výsledné man stránky sestavují speciálně formátované komentáře.Cílem této práce by bylo:

  1. vytvořit přehledný návod jak psát manuálové stránky
    • přehled sekcí manuálových stránek a jejich význam
    • přehled nejpoužívanějších tagů (včetně tabulek)
    • popis doporučeného formátování (standardní odsazení, do které části co patří a jiné konkrétní tipy)
    • napsat několik ukázkových manuálových stránek k existujicim nástrojům/systémovým voláním/... a nechat si je uznat man-pages projektem
  2. přehled manuálových stránek
    • kolik jich je v man-pages, kolik celkem v které distribuci, jak se měnilo jejich množství v čase
    • porovnání množství manuálových stránek přeložených do různých jazyků
    • vytvořit distribučně (například pro Fedora 10, 11, 12, Debian 5.0, 4.0) nezávyslý skript(y), který by zobrazil:
      • množství manuálových stránek v dané distribuci celkem nebo jen pro danou sadu balíků
      • počet manuálových stránek podle sekce
      • zastoupení jednotlivých nástrojů použitých k jejich tvorbě
      • zastoupení tagů formátovacího jazyka manuálových stránek
    • vytvořit webové rozhraní kde by bylo možné zjistit informace per man-page (poslední aktualizace, ...) nebo per distribuce
  3. přehled nástrojů pro vytváření a převod do a z tohoto formátu
    • jaké jsou možnosti automatického generování dokumentace ze zdrojových kódů a které balíky je používají
  4. přehled dalších formátů dokumentace - info a jiné
  5. přehled projektů, které se zabývají překladem manuálových stránek do různých jazyků

Sources of information

$ man man
$ man groff
$ man roff