From 6de911d45ce1b4323050017e8cc1d25668d2e541 Mon Sep 17 00:00:00 2001
From: Martin Cermak <mcermak@redhat.com>
Date: Wed, 27 Jan 2016 08:28:12 +0100
Subject: [PATCH] Align cs/stap.1.in to stap.1.in (doc overview).

---
 man/cs/stap.1.in | 104 ++++++++++++++++++++---------------------------
 1 file changed, 43 insertions(+), 61 deletions(-)

diff --git a/man/cs/stap.1.in b/man/cs/stap.1.in
index 0a159503d..725790b63 100644
--- a/man/cs/stap.1.in
+++ b/man/cs/stap.1.in
@@ -87,67 +87,6 @@ stap \- překladač a řadič systemtap skriptů
 ]
 .B \-\-dump-functions
 
-.SH "ZDROJE INFORMACÍ"
-
-Pro SystemTap existuje pestrá škála dokumentace. Je dostupná jak online na
-adrese https://sourceware.org/systemtap/, tak (z větší části) i v rámci
-distribučních balíčků.
-
-Pro začátečníky je ideální
-.IR "Beginner's Guide".
-Přináší čtivý úvod do základních principů funkce
-nástroje jako celku, jeho skriptovacího jazyka, a také řadu příkladů.
-.IR "Systemtap Tutorial"
-pak jde více do hloubky a obsahuje cvičení.
-.IR "Language Reference"
-Podrobně popisuje syntaxi skriptovacího jazyka systemtapu.  Ta je v základních
-rysech podobná syntaxi jazyků C a awk, ale obsahuje i netradiční prvky, jako
-například statistické nástroje.
-.IR "Tapset Reference"
-přináší přehled rozšiřitelné knihovny tapsetů.  Taktéž je k dispozici rozsáhlá 
-.IR "sbírka příkladů".
-Jsou dostupné jak online setříděné do kategorií na projektovém webu,
-tak i offline v rámci distribučních balíčků, viz
-@prefix@/share/doc/systemtap*/examples. Často jde o přímo použitelné nástroje
-pro analýzu a správu systému.
-
-Seznam manuálových stránek:
-
-.TP
-.BI stapprobes(3stap)
-Přehled sondážních bodů a přezdívek a související syntaxe.
-.TP
-.BI "function::*(3stap), probe::*(3stap), tapset::*(3stap)"
-Individuální manuálové stránky pro jednotlivé funkce, sondážní body a tapsety.
-Kompletní seznam nalezne čtenář v adresáři
-@prefix@/share/man/man3/.
-.TP
-.BI stappaths(7)
-Přehled důležitých umístění v rámci adresářové struktury.
-.TP
-.BI staprun(8)
-Řadič pro jaderné moduly systemtapu.
-.TP
-.BI stapdyn(8)
-Nástroj Dyninst pro dynamickou instrumentaci.
-.TP
-.BI systemtap(8)
-Služba umožňující spustit systemtap skript jako démon.
-.TP
-.BI stapvars(3stap)
-Veřejné proměnné definované knihovnou tapsetů.
-.TP
-.BI stapex(3stap)
-Několik jednoduchých příkladů systemtap syntaxe.
-.TP
-.BI stap-server(8)
-Kompilační server Systemtapu.
-.TP
-.BI stap-prep(1)
-Instalátor závislostí, jako např. ladicích informací jádra.
-.TP
-.BI stapref(1)
-Rychlá reference pro skriptovací jazyk systemtapu.
 
 .SH POPIS
 
@@ -177,6 +116,49 @@ aplikace, případně systémovou událost s obslužnými rutinami, což jsou bl
 kódu vykonávané synchronně.  Koncepčně to připomíná skriptování v
 .IR gdb .
 
+.SH "PŘEHLED DOKUMENTACE"
+
+Pro SystemTap existuje množství vzdělávacích, dokumentačních a referenčních
+materiálů jak v online podobě, tak i v rámci distribučních balíčků.  Online
+dokumentace se nachází na projektovém webu
+.nh
+https://sourceware.org/systemtap/
+.hy
+.
+
+.TS
+tab(%) allbox;
+l l.
+\fBman stránky\fP
+stap (tato stránka)%syntaxe jazyka, koncepty, funkce, volby
+stapprobes%sondážní body a jejich kontextové proměnné
+stapref%rychlá reference pro syntaxi jazyka
+stappaths%T{
+seznam důležitých umístění včetně knih a odkazů
+T}
+stap-prep%T{
+instalátor závislostí jako např. ladicích informací jádra
+T}
+tapset::*%vygenerovaný seznam tapsetů
+probe::*%vygenerovaný seznam tapsetových přezdívek
+function::*%vygenerovaný seznam tapsetových funkcí
+macro::*%vygenerovaný seznam tapsetových maker
+stapvars%vybrané globální proměnné definované v tapsetech
+staprun, stapdyn%programy pro spuštění zkompilovaných systemtap skriptů
+systemtap%systémová služba, analýza startu systému
+stap-server%kompilační server
+stapex%několik velmi jednoduchých příkladů
+\fBknihy\fP%
+Beginner's Guide%učebnice základů s praktickými ukázkami
+Tutorial%hutný úvod, cvičení
+Language Reference%podrobný manuál skriptovacího jazyka
+Tapset Reference%man stránky tapsetů v podobě knihy
+\fBodkazy\fP%
+example scripts%T{
+množství nástrojů pro správu systému, ukázkových skriptů a výukových hraček
+T}
+.TE
+
 .SH VOLBY
 
 Příkaz
-- 
2.43.5