Az info parancs
- Rework to be less verbose.
- etc.
Az info parancs az info oldalak (súgóoldalak) megtekintésére és navigálására szolgál. Ezek az info oldalak a számítógépes szoftverek dokumentációját tartalmazzák. Az info szoftver a Texinfo dokumentációs rendszer része.
A legtöbb felhasználó ismeri a man dokumentációs rendszert (mondják még man súgórendszernek is). Bár a man hasznos a gyors keresésekhez, hiányzik belőle az összekapcsolt oldalstruktúra. Az info súgóoldalak összekapcsolhatók más súgóoldalakkal, menük létrehozását és általános navigációt tesznek lehetővé. A man súgóoldalak tartalma néha kiegészíti az info rendszer tartalmát, néha eltérő lehet, és előfordulhat, hogy csak az egyik súgórendszer tartalmaz információt.
Az info súgóoldalak internetkapcsolat nélkül is elérhetőek. A fájlok általában a /usr/share/info könyvtárban találhatók meg a számítógépen, de megtekintésükhöz speciális szoftver, például az info parancs szükséges.
Nagyon nagy előnyt jelent, ha egy operációs rendszeren a dokumentáció szabványosított és könnyen elérhető módon van jelen. Linux környezetben a szokás általában az, hogy először az info és man súgóoldalakon keresünk válaszokat a kérdéseinkre. Ez a módszer már csak azért is nagyon jó gyakorlat, mivel ezek a súgóoldalak gyakran a legteljesebb rendelkezésre álló dokumentációt tartalmazzák.
Telepítés
Az információ már jelen lehet egyes rendszereken, ebben az esetben ezt a szakaszt kihagyhatja. Írja be a whereis info parancsot (hozzátartozik a sys-apps/util-linux szoftvercsomaghoz, amely általában része a system set rendszerkészletnek) annak érdekében, hogy meghatározza, vajon telepítve van-e már a info.
Emerge
Telepítse a sys-apps/texinfo szoftvercsomagot:
root #emerge --ask sys-apps/texinfoPinfo
A pinfo (a app-text/pinfo szoftvercsomagból) egy színes alternatíva a info megjelenítőhöz, kibővített böngészési lehetőségekkel. Ha szükséges, akkor ezt telepítheti a sys-apps/texinfo szoftvercsomag helyett vagy azzal párhuzamosan is telepítheti (ebben az esetben a info helyett használja a pinfo parancsot a dokumentum további részében).
root #emerge --ask sys-apps/pinfoTovábbi információért tekintse meg a pinfo dokumentációját, a weboldalát és a GitHub weboldalát.
Használat
Futtatás
Az információs oldalak megtekintésének és böngészésének megkezdéséhez indítsa el a info parancsot argumentum nélkül. Ön egy áttekintést kap az operációs rendszeren tárolt dokumentációról.
user $infoOpciók:
user $info --helpUsage: info [OPTION]... [MENU-ITEM...]
Olvassa el a dokumentációt Info formátumban.
Frequently-used options:
-a, --all use all matching manuals
-k, --apropos=STRING look up STRING in all indices of all manuals
-d, --directory=DIR add DIR to INFOPATH
-f, --file=MANUAL specify Info manual to visit
-h, --help display this help and exit
--index-search=STRING go to node pointed by index entry STRING
-n, --node=NODENAME specify nodes in first visited Info file
-o, --output=FILE output selected nodes to FILE
-O, --show-options, --usage go to command-line options node
--subnodes recursively output menu items
-v, --variable VAR=VALUE assign VALUE to Info variable VAR
--version display version information and exit
-w, --where, --location print physical location of Info file
Az első nem opcióként megadott argumentum – ha jelen van – az a menübejegyzés, amelyből kiindul. Az INFOPATH mentén minden 'dir' fájlban megkeresi azt. Ha nincs jelen, akkor az info egyesíti az összes 'dir' fájlt, és megjeleníti az eredményt. A fennmaradó argumentumokat a meglátogatott kezdő csomóponthoz viszonyított menüpontok neveiként kezeli.
A kulcskötések összefoglalásához nyomja le az Info szoftveren belül a {{Key|H}} billentyűgombot.
Examples:
info show top-level dir menu
info info-stnd show the manual for this Info program
info emacs start at emacs node from top-level dir
info emacs buffers select buffers menu entry in emacs manual
info emacs -n Files start at Files node within emacs manual
info '(emacs)Files' alternative way to start at Files node
info --show-options emacs start at node with emacs' command line options
info --subnodes -o out.txt emacs
dump entire emacs manual to out.txt
info -f ./foo.info show file ./foo.info, not searching dir
Email bug reports to [email protected],
general questions and discussion to [email protected].
Texinfo home page: http://www.gnu.org/software/texinfo/Az info súgóoldalak böngészése
Most, hogy az info elindult, a képernyő hasonló lesz ehhez:
File: dir, Node: Top This is the top of the INFO tree
This (the Directory node) gives a menu of major topics.
Typing "q" exits, "?" lists all Info commands, "d" returns here,
"h" gives a primer for first-timers,
"mEmacs<Return>" visits the Emacs manual, etc.
In Emacs, you can click mouse button 2 on a menu item or cross reference
to select it.
* Menu:
User Interface Toolkit
* GDK: (gdk). The General Drawing Kit
* GTK: (gtk). The GIMP Toolkit
GNU programming tools
* Autoconf v2.1: (autoconf). Create source code configuration scripts.
Jelenleg számos bejegyzés található, amelyek előtt csillag (*) van. Ezek menüpontok, amelyek segítségével különböző csomóponti szinteken lehet navigálni.
Kétféle módon lehet menüket kiválasztani: Nyilakkal vagy számmal. A wget szoftverhez tartozó info súgóoldalának megtekintéséhez a nyílbillentyűkkel navigálva használja a ↓ billentyűgombot, amíg el nem éri a wget sorát.
Network Applications
* GnuTLS: (gnutls). Package for Transport Layer Security.
* Wget: (wget). The non-interactive network downloader.
* certtool: (gnutls)Invoking certtool. Manipulate certificates and keys.
* gnutls-cli: (gnutls)Invoking gnutls-cli. GNU TLS test client.
* gnutls-cli-debug: (gnutls)Invoking gnutls-cli-debug. GNU TLS debug client.
* gnutls-serv: (gnutls)Invoking gnutls-serv. GNU TLS test server.
* srptool: (gnutls)Invoking srptool. Simple SRP password tool.
Miután ezen a soron van, nyomja meg a Enter billentyűgombot a menüpont kiválasztásához. Ez megnyitja a wget info súgóoldalát.
File: wget.info, Node: Top, Next: Overview, Up: (dir)
Wget 1.10.2
***********
This manual documents version 1.10.2 of GNU Wget, the freely available
utility for network downloads.
Copyright (C) 1996-2005 Free Software Foundation, Inc.
* Menu:
* Overview:: Features of Wget.
* Invoking:: Wget command-line arguments.
* Recursive Download:: Downloading interlinked pages.
* Following Links:: The available methods of chasing links.
* Time-Stamping:: Mirroring according to time-stamps.
* Startup File:: Wget's initialization file.
A csomópontok tekintetében ez a Top csomópontnak minősül a wget súgóoldal számára. A Top csomópontot tekintse az adott info súgóoldal tartalomjegyzékének megfelelőnek.
Az súgóoldal böngészéséhez a felhasználók többféle módszert alkalmazhatnak. Az első a standard info módszer. Ebben az esetben a Space billentyűvel lehet előre lépni egy oldalnyit, míg a Backspace/Delete billentyűkkel lehet visszalépni egy oldalnyit. Ez az ajánlott módszer, mivel automatikusan a dokumentum megfelelő csomópontjára léptet előre vagy léptet hátra. Ha a felhasználók teljes csomópontokat szeretnének kihagyni a Space/Backspace/Delete billentyűk használata nélkül, akkor a [ (visszalépés) és a ] (előrelépés) billentyűket is alkalmazhatják.
Egy másik navigációs módszer a Page up/Page down billentyűgombok használata. Ezek működnek, de nem léptetnek előrefelé vagy hátrafelé úgy, mint a Space/Backspace/Delete billentyűgombok.
Mint korábban említettük, a menüelemek kiválasztásának kettő módja van. Most a második módszert ismertetjük. Az 1-9 számokat lehet használni az elsőtől a kilencedikig terjedő menüpontok hivatkozására egy dokumentumon belül. Ez lehetővé teszi a dokumentumok gyors áttekintését. Például a felhasználók megnyomhatják a 3 billentyűgombot, hogy elérjék a Recursive Download menüpontot. Nyomja meg a 3 billentyűgombot, és megjelenik a Recursive Download a képernyőn.
File: wget.info, Node: Recursive Download, Next: Following Links, Prev: Invoking, Up: Top
3 Recursive Download
********************
GNU Wget is capable of traversing parts of the Web (or a single HTTP or
FTP server), following links and directory structure. We refer to this
as to "recursive retrieval", or "recursion".
Ez egy jó alkalom néhány dolog megjegyzésére. Először is, a felső fejléc szakasz. Ez a fejléc megmutatja az adott képernyőn elérhető navigációs lehetőségeket. A Next: által jelzett oldal eléréséhez nyomja meg a n billentyűgombot, míg a Prev: által jelzett oldalhoz a p billentyűgombot nyomja meg. Fontos megjegyezni, hogy ez csak azonos szinten működik. Ha túlzottan sokat használja ezt a funkciót, akkor előfordulhat, hogy teljesen irreleváns tartalomhoz kerül. Jobb, ha a Space/Backspace/Delete/[/] billentyűgombokat használja a lineáris navigáció érdekében.
Ha a felhasználók valamilyen okból eltévednek, akkor több módjuk is van a kilépésre. Az első lehetőség a t billentyűgomb. Ez egyenesen az adott info súgóoldal felső szintjére (tartalomjegyzékére) viszi a felhasználót. Ha a felhasználók vissza szeretnének térni az utoljára megtekintett oldalra, akkor ezt az l billentyűgombbal tehetik meg. Ha egy szinttel feljebb szeretnének lépni, akkor az u billentyűgombot használhatják. A következő fejezet a tartalom keresését vizsgálja meg.
Most, hogy a felhasználók képesek egyéni info súgóoldalon navigálni, fontos megvizsgálni más info súgóoldalak elérését is. Az első nyilvánvaló módszer az, hogy az info súgóoldalakat az info súgóoldalakat felsoroló dir indexen keresztül érjük el. Ha egy dokumentum mélyéről szeretné elérni a dir indexet, akkor egyszerűen nyomja meg a d billentyűgombot. Innen a felhasználók megkereshetik a kívánt megfelelő súgóoldalt. Ha azonban ismerik a pontos súgóoldalt, akkor van egy egyszerűbb módszer a Goto node (g billentyűgomb) parancs segítségével. Egy info súgóoldal nevének megadásához nyomja meg a g billentyűgombot annak érdekében, hogy megjelenjen a prompt, majd zárójelben adja meg az oldal nevét.
* Startup File:: Wget's initialization file.
* Examples:: Examples of usage.
* Various:: The stuff that doesn't fit anywhere else.
* Appendices:: Some useful references.
* Copying:: You may give out copies of Wget and of this manual.
--zz-Info: (wget.info.gz)Top, 24 lines --Top-------------------------------
Goto node: (libc)
Ez megnyitja a libc súgóoldalt, ahogyan az itt látható:
File: libc.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir)
Main Menu
*********
This is Edition 0.10, last updated 2001-07-06, of `The GNU C Library
Reference Manual', for Version 2.3.x of the GNU C Library.
* Menu:
* Introduction:: Purpose of the GNU C Library.
Most, hogy a felhasználók tudják, hogy név szerint miként érhetnek el info súgóoldalakat, a következő szakasz az info súgóoldalak indexén keresztüli keresés módjait vizsgálja meg.
Információ keresése az info szoftverben
Keresés index segítségével
A következő példa bemutatja, hogy miként lehet megkeresni a printf függvényt a C könyvtárban a libc info súgóoldal indexét használva. A felhasználóknak továbbra is a libc info oldalon kell lenniük az előző szakasz alapján. Ha nem így van, akkor a Goto node parancs segítségével elérhetik azt. Az indexkeresés használatához nyomja meg az i billentyűgombot a prompt megjelenése érdekében, majd adja meg a keresési kifejezést.
* Character Set Handling:: Support for extended character sets.
* Locales:: The country and language can affect the
behavior of library functions.
* Message Translation:: How to make the program speak the user's
language.
--zz-Info: (libc.info.gz)Top, 1291 lines --Top-- Subfile: libc.info-1.gz-----
Index entry: printf
Miután a lekérdezés befejezése után megnyomja a Enter billentyűt, a felhasználó a libc definíciójához jut a printf függvényhez.
File: libc.info, Node: Formatted Output Functions, Next: Dynamic Output, Prev: Other Output Conversions, Up: Formatted Output
12.12.7 Formatted Output Functions
----------------------------------
This section describes how to call `printf' and related functions.
Prototypes for these functions are in the header file `stdio.h'.
Because these functions take a variable number of arguments, you _must_
declare prototypes for them before using them. Of course, the easiest
way to make sure you have all the right prototypes is to just include
A felhasználók sikeresen végeztek keresést a libc információs oldal indexén keresztül. Azonban előfordulhat, hogy az általuk keresett információ közvetlenül az oldalon található. A következő szakasz azt vizsgálja meg, hogy miként lehet kereséseket végezni az oldalon belül.
Keresés a search parancs segítségével
A korábbi Formatted Output Functions csomópontból kiindulva a felhasználók megvizsgálják a sprintf változat keresését a printf függvényen belül. A keresés végrehajtásához nyomja meg a s billentyűgombot a search prompt megjelenítéséhez, majd adja meg a keresési feltételeket (ebben az esetben sprintf).
-- Function: int wprintf (const wchar_t *TEMPLATE, ...)
The `wprintf' function prints the optional arguments under the
control of the wide template string TEMPLATE to the stream
`stdout'. It returns the number of wide characters printed, or a
--zz-Info: (libc.info.gz)Formatted Output Functions, 127 lines --Top-- Subfile: libc.info-3.gz--
Search for string []: sprintf
Nyomja meg a Enter billentyűgombot, és megjelenik a keresési eredmény.
-- Function: int sprintf (char *S, const char *TEMPLATE, ...)
This is like `printf', except that the output is stored in the
character array S instead of written to a stream. A null
character is written to mark the end of the string.
The `sprintf' function returns the number of characters stored in
the array S, not including the terminating null character.
Ez a szükséges funkció.
Adathordozón tárolt info súgóoldalak
Az info súgóoldalak (súgófájlok) főként a /usr/share/info könyvtárban találhatóak meg. A man súgóoldalaktól eltérően a /usr/share/info könyvtár egy meglehetősen kiterjedt súgófájlgyűjteményt tartalmaz. Ezek a súgófájlok a következő formátumban érhetők el:
pagename.info[-node].gz
A pagename az súgóoldal tényleges neve (például: wget). A [-node] egy opcionális szerkezet, amely egy másik csomóponti szintet jelöl (általában az adott info dokumentum felső szintje hivatkozik rá).
Az info súgóoldalak alapértelmezés szerint a gzip formátumba vannak betömörítve a helytakarékosság érdekében. A tömörítési algoritmus megváltoztatásához állítsa be a PORTAGE_COMPRESS változót a /etc/portage/make.conf fájlban.
További info súgóoldalak az INFOPATH környezeti változó segítségével jeleníthetők meg (általában a különféle /etc/env.d/ fájlokon keresztül van beállítva).
A /usr/share/info/dir fájl akkor kerül felhasználásra, amikor az info parancs paraméterek nélkül fut. Ez a fájl tartalmazza az összes elérhető info oldal listáját, amelyeket a felhasználók böngészhetnek.
További eszközök
A könnyebb és felhasználóbarátabb grafikus felületen történő böngészés érdekében a következő szoftverek állnak rendelkezésre:
- app-text/info2html - Az info súgóoldalak böngészhető HTML formátumba való átkonvertálása.
- app-text/pinfo - ncurses alapú info súgómegjelenítő.
- app-text/tkinfo - Egy tcl/tk alapú info súgóböngésző.
- app-vim/info - Egy vim alapú info súgóböngésző.
Ez a KDE böngészője. A Konqueror tehát, szintén lehetővé teszi a felhasználók számára, hogy az info: URI segítségével info súgóoldalakat böngésszenek.
További dokumentáció
Az info parancs használható a saját maga dokumentációjának a megtekintésére is:
user $info info- A man súgóban is van dokumentáció az info paranccsal kapcsolatban:
user $man infoTovábbi olvasnivaló a témában
- Man page — contains system reference documentation. It is found on most Unix-like systems.
- tldr — a succinct help system for CLI commands.
This page is based on a document formerly found on our main website gentoo.org.
The following people contributed to the original document: Chris White
They are listed here because wiki history does not allow for any external attribution. If you edit the wiki article, please do not add yourself here; your contributions are recorded on each article's associated history page.