Apa itu Info GNU?

Saya mengerti apa GNU Info yang dan bagaimana menggunakannya, tapi apa itu untuk ? Mengapa ada paralel dengan halaman manual? Mengapa tidak menulis halaman manual terperinci daripada menyediakan utilitas terpisah?

Info GNU dirancang untuk menawarkan dokumentasi yang komprehensif, hyperlink, dan memungkinkan untuk dihasilkan ke berbagai format.

Halaman manual tersedia, dan mereka hebat dalam menyediakan hasil cetak. Namun, mereka dirancang sedemikian rupa sehingga setiap halaman manual memiliki set konten yang cukup kecil. Halaman manual mungkin memiliki diskusi tentang fungsi C tunggal seperti printf (3), atau akan menggambarkan perintah ls (1).

Itu rusak ketika Anda masuk ke sistem yang lebih besar. Bagaimana Anda memasukkan dokumentasi untuk Emacs ke halaman manual? Contoh masalahnya adalah halaman manual Perl, yang berisi 174 halaman manual terpisah yang dapat Anda baca untuk mendapatkan informasi. Bagaimana Anda menjelajahinya, atau melakukan pencarian untuk mencari tahu apa artinya &&?

Sebagai peningkatan dari halaman manual, Info memberi kami:

1. Kemampuan untuk memiliki satu dokumen untuk sistem besar, yang berisi semua informasi tentang sistem itu. (dibandingkan 174 halaman manual)
2. Kemampuan untuk melakukan pencarian teks lengkap di seluruh dokumen (v. Man -k yang hanya memeriksa kata kunci)
3. Hyperlink ke berbagai bagian dokumen yang sama atau berbeda (v. Bagian Lihat Juga, yang dibuat menjadi hyperlink oleh beberapa, tetapi tidak semua, pemirsa halaman manual)
4. Indeks untuk dokumen, yang dapat diramban atau Anda bisa menekan "i" dan mengetikkan istilah dan itu akan mencari indeks dan membawa Anda ke tempat yang tepat (v. Tidak ada)
5. Penjelajahan dokumen linear di seluruh konsep, memungkinkan Anda membaca bagian sebelumnya dan berikutnya jika Anda mau, baik dengan mouse atau keystroke (v. Nothing).

Apakah masih relevan? Saat ini kebanyakan orang akan mengatakan "Dokumentasi ini bukan milik halaman manual" dan akan menaruhnya di PDF atau memasangnya di HTML. Faktanya, sistem bantuan pada beberapa OS didasarkan pada HTML. Namun, ketika Info GNU dibuat (1986), HTML belum ada. Saat ini texinfo memungkinkan Anda membuat PDF, Info, atau format lain, sehingga Anda dapat menggunakan format tersebut jika diinginkan.

Karena itulah Info GNU ditemukan.

Alasan mengapa sistem Info ditemukan adalah keharusan, tetapi saya kira "kemalasan, keangkuhan, dan ketidaksabaran" adalah penjelasan yang sama baiknya.

Inti dari proyek GNU adalah untuk mengembangkan sistem dan perangkat operasi yang dapat dimodifikasi dan didistribusikan secara bebas. Sistem manusia Unix tradisional didasarkan pada sistem pemformatan dokumen nroff / troff dari Bell Labs, yang pada saat itu merupakan perangkat lunak komersial (tidak bebas). Akhirnya sistem itu direkayasa terbalik dan penggantian gratis yang disebut groff dibuat, tetapi itu beberapa tahun setelah proyek GNU dimulai. Jadi menggunakan sistem manual untuk dokumentasi GNU sebelum itu akan membutuhkan penerapan penggantian troff, suatu usaha besar.

Sementara itu, GNU Emacs adalah proyek besar pertama dari GNU dan membutuhkan dokumentasi yang luas. Menghadapi segunung pekerjaan yang mengimplementasikan sistem GNU, Richard Stallman mencari perangkat lunak yang ada yang dapat ia gunakan dalam sistemnya. TeX sudah ada dan memiliki kemampuan format dokumen yang kuat. Tidak seperti nroff / troff, TeX bebas untuk digunakan dan didistribusikan. Texinfo diciptakan sebagai sistem dokumentasi untuk memanfaatkan kekuatan TeX untuk manual yang dicetak dan GNU Emacs untuk memproses dan membaca dokumentasi online. Prosesor Texinfo asli dan browser dokumen Info keduanya ditulis dalam Lisp dan dijalankan di dalam Emacs. Utilitas mandiri Texinfo datang beberapa tahun kemudian.

Seperti yang dikatakan halaman Wikipedia , TeXinfo dirancang sebagai dokumentasi resmi proyek GNU oleh Richard Stallman. Ini adalah seperangkat makro di atas TeX, dan dirancang untuk menulis manual perangkat lunak. Saya pikir Stallman menganggap halaman manual tidak cukup untuk tugas itu. Dua keuntungan yang dimiliki Texinfo dibandingkan halaman manual adalah bahwa itu hyperlink, dan kedua, bahwa, secara desain mudah dikonversi ke format lain.

TAMBAHAN: Meskipun tidak sepenuhnya relevan dengan pertanyaan, perhatikan bahwa halaman manual masih dianggap sebagai sistem dokumentasi standar pada sistem mirip Unix gratis seperti yang berjalan di atas kernel Linux dan juga berbagai rasa BSD. Misalnya, templat paket Debian mendorong penambahan halaman manual untuk semua perintah, dan juga cek lintian untuk halaman manual. Texinfo masih belum banyak digunakan di luar proyek GNU.

Dari praktis pandangan, infoadalah yang paling rinci dari tiga tingkat dokumentasi referensi:

Tiga level biasanya meningkat secara rinci:

--helpsebagai opsi perintah umum - ringkasan penggunaan singkat ,
man- halaman manual klasik, referensi cepat , dan
info- manual GNU-speciffic yang lebih rinci - dokumentasi resmi lengkap .

Jika infohalaman tidak tersedia, halaman manual biasanya berisi dokumentasi lengkap.

Perhatikan bahwa halaman manual berisi informasi yang persis sama seperti --helpkeluaran untuk banyak perintah dari GNU coreutils - misalnya ls;

Bandingkan ls --helpdan man lsuntuk melihat bahwa perbedaannya hanya dalam memformat.

pinfo ls

konqueror info:ls

1 - teknologi canggih, tetapi ringan

Halaman manual datar.

info adalah sebuah pohon.

Keduanya tetap berbasis teks , sehingga dapat digunakan selama pengembangan sistem tingkat rendah, (tidak seperti http, yang membutuhkan GUI dan browser yang penuh sesak sebelum Anda dapat menggunakannya.)

Ini juga berguna karena linux dapat berjalan di banyak mesin sumber daya rendah, misalnya, hal-hal yang berjalan di Arduino saya dari Atmel ditemukan di Linux info.

(Sejarah: infomirip dengan gopher , jika Anda ingat itu. Itu adalah apa yang kami miliki sebelum kita semua pindah ke OS GUI, dan dunia web meledak. Saya ingat bahwa gopher bekerja cukup baik untuk menemukan informasi, dan itu cepat dan sederhana. Itu mudah diperluas, sepenuhnya berbasis teks, dan cepat.)

Halaman manual tidak dapat memiliki hyperlink yang dapat dioperasikan. (Tidak mungkin dalam teknologi ini.)

infodapat dan memang memiliki banyak tautan yang dapat dioperasikan dari node ke node, atau dari node ke leaf, membuatnya lebih mudah untuk menavigasi manual besar dengan cepat.

2 - mengandung konten yang tidak ditemukan di halaman manual

Banyak paket standar juga memiliki paket -doc . Seringkali konten ini kemudian hanya ditemukan di dalam info.

Paket dokumentasi ini menambahkan buklet info di dalam, dengan bagian, dan sub-bagian. Dalam infoistilah, ini disebut nodes, dan node dapat berisi lainnya nodesdalam struktur pohon.

Ada perintah untuk memanjat pohon, berikut adalah beberapa contoh:

• up bagian, misalnya dari bagian 2.1 ke bagian 2
• bagian berikutnya (yaitu, bergerak di sepanjang kiat cabang dari halaman ke halaman), misalnya dari Bagian 2, ke Bagian 2.1, dan ( dengan asumsi tidak ada Bagian 2.2 ), seterusnya ke Bagian 3
• kanan bagian, misalnya dari Bagian 2 langsung ke Bagian 3, melewatkan bagian 2.1

Jika Anda membaca dan menggulir ke bawah baris demi baris, maka Anda akan mengunjungi semua bagian dari setiap buklet.

Perintah penting

l - kembali - Huruf kecil 'L', seperti dalam l ast. Ini seperti tombol kembali di browser web Anda. - Kembali ke simpul terakhir yang terlihat di jendela ini (awalnya kami hanya memiliki satu jendela). Wow, kita juga bisa membagi jendela dokumen menjadi dua!

d - orang-orang saya - Pergi ke simpul ' d irectory' utama. - Ini adalah puncak pohon INFO. Berisi tautan ke keluarga:

t - keluarga saya - Pergi ke t simpul op dokumen ini. - Umumnya daftar isi

u - orang tua saya - Pergi u p satu tingkat. misalnya pergi dari Bagian 2.1, ke Bagian 2.

n - saudara saya - Pergi ke simpul n ext pada tingkat ini. mis. bagian 2 -> bagian 3 (bukan 2.1)

p - saudara saya - Pergi ke simpul re p pada tingkat ini. misal bagian 3 -> bagian 2

] - anak-anak saya - Pergi ke simpul berikutnya dalam dokumen, misalnya bagian 2 -> bagian 2.1

[ - anak-anak saya - Pergi ke simpul sebelumnya dalam dokumen, misalnya bagian 2.1 -> bagian 2

Saya juga tidak begitu mengerti mengapa saya ingin menggunakan info. Saya sebelumnya mencoba-coba di dalamnya, dan pada awalnya menemukannya old-school. Tetapi karena saya memerlukan lebih banyak informasi untuk proyek autoconf , dan disarankan kepada saya bahwa di sinilah dokumentasi itu, saya melihat lagi baru-baru ini.

Hal pertama yang harus saya lakukan adalah mencari tahu cara menavigasi yang lebih baik. Saya menemukan bantuan yang diberikan oleh H hampir tidak membantu. Itu sampai saya perhatikan bahwa saya dapat menggulir ke bawah ke bantuan ini, ... tapi kemudian ada terlalu banyak kebingungan.

Jadi saya menyalin bantuan ini dan menempelkannya bersama menjadi Gnote, dan mulai mencoba memahami bagaimana cara infokerjanya.

Ketika saya belajar lebih banyak, saya menulis ulang bantuan mereka untuk diri saya sendiri. Saya ingin tahu apa perintah lengkapnya, dan bagaimana mereka dikategorikan.

Saya perhatikan bahwa banyak tombol-stroke digandakan, dengan 2 atau 3 cara untuk mengeksekusi perintah yang diberikan. Saya juga memperhatikan bahwa ini semua sangat mirip dengan emacs.

Ini adalah lembar contekan saya dari perintah info :

HELP - info - commands

#####################################################################################################################################################
Short list - 'basic' Info command keys (see below for full list)

        C-g         Cancel the current operation.
        H           Close this help window. (toggle help window)
        q           Quit Info altogether.

        h           Invoke the Info tutorial.


        Move in this node
                Up          Move up one line.
                Down        Move down one line.


                PgUp        Scroll backward one screenful.      - also backspace
                PgDn        Scroll forward  one screenful.      - also     space

                Home        Go to the beginning of this node.
                End         Go to the end       of this node.

                TAB         Skip to the next    hypertext link.

                /           Search forward for a specified string.
                }           Search for next     occurrence.
                {           Search for previous occurrence.

        Move to other nodes
                RET         Follow the          hypertext link under the cursor.

                1...9       Pick the first...ninth item in this node's menu.
                0           Pick the last item in this node's menu.

                l           Last in history.  Go back to the last node seen in this window (initially we only have one window). (?? history)


                d           Go to the main 'directory' node.                    my people
        the Info main menu - "This is the top of the INFO tree."

                t           Go to the top node of this document.                my family       Generally the table of contents

                u           Go up one level.                                    my parent       e.g. go from Section 2.1, to Section 2.

                n           Go to the next     node on this level.              my siblings     e.g. section 2 -> section 3  (not 2.1)
                p           Go to the previous node on this level.

                ]           Go to the next     node in the document.            my children     e.g. section 2 -> section 2.1
                [           Go to the previous node in the document.  (?siblings)


                m <name>    Pick a menu item specified by name.
                f           Follow a cross reference specified by name.
                g           Go to a node specified by name.

                i           Search for a specified string in the index (if there is an index), and select the node referenced by the first entry found.

                I           Synthesize menu of matching index entries. ???




#####################################################################################################################################################
Full list - of commands available in Info windows:

Notes: 
        M-              (meta) is Alt;  (also you can use an Esc prefix instead of meta -hwj)
        M-C-            means hold both Ctrl and Alt down at same time
        *               Basic commands (listed above)



     HELP
*               H                                       (get-help-window)               Toggle display of help message
*               h                                       (get-info-help-node)            Visit Info node '(info)Help' (this gets:  man info )


     CANCEL
*                       C-g     C-x C-g M-C-g           (abort-key)                     Cancel current operation  (?? esc)

*               q       C-c                             (quit)                          Quit using Info
                        C-x C-c                         (quit)                          Quit using Info


     WINDOWS
                        C-l                             (redraw-display)                Redraw the display

                x       C-x 0                           (delete-window)                 Delete the current window
                        C-x 1                           (keep-one-window)               Delete all other   windows (leaving 1)

                        C-x 2                           (split-window)                  Split the current  window  (into 2)
                        C-x t                           (tile-windows)                  Divide the available screen space among the visible windows

                        C-x ^                           (grow-window)                   Grow (or shrink) this window

                        C-x o                           (next-window)                   Select the next window (other)

                        C-x C-b                         (list-visited-nodes)            Make a window containing a menu of all of the currently visited nodes

                        C-x w                           (toggle-wrap)                   Toggle the state of line wrapping in the current window

     VIEW OTHER FILE
                        C-x C-f                         (view-file)                     Read the name of a file and select it
                        C-x C-v                         (view-file)                     Read the name of a file and select it


     SCROLL
                        C-v                             (scroll-forward-page-only)      Scroll forward  in this window staying within node      ('v' looks like a down arrow)
                                M-v                     (scroll-backward-page-only)     Scroll backward in this window staying within node      (meta-v is the reverse, or up arrow)

*       PgDn    SPC                                     (scroll-forward)                Scroll forward  in this window (at end moving to next node??)
*       PgUp    DEL     C-h                             (scroll-backward)               Scroll backward in this window (at end moving to next node??)  (DEL = Backspace or Del)

                                M-C-v   ESC PgDn        (scroll-other-window)           Scroll the other window
                                        ESC PgUp        (scroll-other-window-backward)  Scroll the other window backward


     CURSOR MOVEMENT (within a 'node' / page)
        Right           C-f                             ( forward-char)                 Move forward  a character
        Left            C-b                             (backward-char)                 Move backward a character

                                M-b                     (backward-word)                 Move backward a word
                                M-f                     ( forward-word)                 Move forward  a word

                        C-a                             (beginning-of-line)             Move to the start of the line
                        C-e                             (end-of-line)                   Move to the end   of the line


*       Up              C-p                             (prev-line)                     Move up   to the previous line
*       Down            C-n                             (next-line)                     Move down to the next     line

                                M-r                     (move-to-window-line)           Move the cursor to a specific line of the window

*       Home    b               ESC <                   (beginning-of-node)             Move to the start of this node
*       End     e               ESC >                   (end-of-node)                   Move to the end   of this node


     SEARCHING
                /                                       (search)                        Read a string and search          for it
                s                                       (search)                        Read a string and search          for it
                ?                                       (search-backward)               Read a string and search backward for it

                R                                       (toggle-regexp)                 Toggle the usage of regular expressions in searches

                S                                       (search-case-sensitively)       Read a string and search for it case-sensitively

*               }       C-x n                           (search-next)                   Repeat last search in the same    direction
*               {       C-x N                           (search-previous)               Repeat last search in the reverse direction


                        C-s                             (isearch-forward)               Search interactively for a string as you type it
                        C-r                             (isearch-backward)              Search interactively for a string as you type it


                                M-/                     (tree-search)                   Search this node and subnodes for a string.

                                M-}                     (tree-search-next)              Go to next     match in Info sub-tree
                                M-{                     (tree-search-previous)          Go to previous match in Info sub-tree


     JUMP TO NODE CROSS REFERENCES (underlined links to nodes)
*               TAB                                     (move-to-next-xref)             Move to the next     cross reference
                BackTab         M-TAB                   (move-to-prev-xref)             Move to the previous cross reference  (Shift-tab)


     SELECT A NODE (hyperlink)
*               RET                                     (select-reference-this-line)    Select reference or menu item appearing on this line

*               1 .. 9                                  (menu-digit)                    Select this     menu item (link) # in this node's menu (this page's menu)
*               0                                       (last-menu-item)                Select the last menu item (link)   in this node's menu (this page's menu)

                <                                       (first-node)                    Select the first node in this file
                >                                       (last-node)                     Select the last  node in this file


*               d                                       (dir-node)                      Select the 'dir' node (in all files?)   the Info main menu - "This is the top of the INFO tree."

*               t                                       (top-node)                      Select the 'Top' node in this file      Generally the table of contents
*               u                                       ( up-node)                      Select the 'Up'  node in this file      i.e. go from Section 2.1, to Section 2.


*               n                                       (next-node)                     Select the Next node                    i.e. section 2.1 -> section 2.2
*               p                                       (prev-node)                     Select the Prev node


*               g <name>                                (goto-node)                     Read a node name and select it
*               m <item>                                (menu-item)                     Read a menu item and select its node    ???


                        C-x b                           (select-visited-node)           Select a node which has been previously visited in a visible window (c-x=Window, back)



     MOVE TO ANOTHER NODE (in the tree)
*               [                                       (global-prev-node)              Move backwards or up   through node structure (tree within this file)
*               ]                                       (global-next-node)              Move forwards  or down through node structure (tree within this file)

*               l                                       (history-node)                  last - Select the most recently selected node

     GET NODE INFORMATION
                =                                       (display-file-info)             Show full file name of node being displayed
                O                                       (goto-invocation-node)          Find the node describing program invocation


     READ IN NEW MENUS
                G <menus>                               (menu-sequence)                 Read a list of menus starting from dir and follow them  ???


     INDEX
*               i                                       (index-search)                  Look up a string in the index for this file (Search for a specified string in the index 
                                                                                                (if there is an index), and select the node referenced by the first entry found.

                ,                                       (next-index-match)              Go to the next matching index item from the last 'i' command

*               I                                       (virtual-index)                 List all matches of a string in the index

                        C-x f                           (all-files)                     Show all matching files


     FOOTNOTES
*               f                                       (xref-item)                     Read a footnote or cross reference and select its node
                r                                       (xref-item)                     Read a footnote or cross reference and select its node

                                M-C-f                   (show-footnotes)                Show the footnotes associated with this node in another window

     NUMERIC 
                        C-u                             (universal-argument)            Start (or multiply by 4) the current numeric argument
                                M--                     (add-digit-to-numeric-arg)      Add this digit to the current numeric argument
                                M-0 .. M-9              (add-digit-to-numeric-arg)      Add this digit to the current numeric argument


     MISC
                                M-x                     (execute-command)               Read a command name in the echo area and execute it     ?? pwd and ls don't work


#####################################################################################################################################################
The following text commands can only be invoked via M-x (Alt-x -hwj):

        This is a list of longer commands that can be typed, all prefixed with Alt-x:


        M-x scroll-forward-set-window                   Scroll forward  in this window                          and set default window size
        M-x scroll-backward-set-window                  Scroll backward in this window                          and set default window size

        M-x scroll-forward-page-only-set-window         Scroll forward  in this window  staying within node     and set default window size
        M-x scroll-backward-page-only-set-window        Scroll backward in this window  staying within node     and set default window size

        M-x down-line                                   Scroll down by lines
        M-x   up-line                                   Scroll up   by lines

        M-x scroll-half-screen-down                     Scroll down by half screen size
        M-x scroll-half-screen-up                       Scroll up   by half screen size


        M-x prev-window                                 Select the previous             xwindow

        M-x set-screen-height <number>                  Set the height of the displayed window

        M-x  find-menu                                  Move to the start of this node's menu

        M-x visit-menu                                  Visit as many menu items at once as possible

        M-x man <name of man page>                      Read a manpage reference and select it


        M-x print-node                                  Pipe the contents of this node through INFO_PRINT_COMMAND


        M-x clear-search                                Clear displayed search matches


        M-x describe-key <key combo>                    Print documentation for KEY  (one line of documentation)
        M-x where-is                                    Show what to type to execute a given command
        M-x describe-command                            Read the name of an Info command and describe it


        M-x index-apropos                               Grovel all known info file's indices for a string and build a menu (grep widely, and make a menu of what is found)


        M-x describe-variable                           Explain the use of a     variable
        M-x      set-variable                           Set the value of an Info variable


        M-x info-version                                Display version of Info being run




#####################################################################################################################################################
Commands available in the 'echo' area (i.e. at bottom of screen):

        (M- (meta) = Fn  (not alt) -hwj)


        C-l             (redraw-display)                        Redraw the display

        C-g     Esc     (echo-area-abort)                       Cancel or quit operation
        M-C-g           (echo-area-abort)                       Cancel or quit operation


     MOVE
        C-a     Home    (echo-area-beg-of-line)                 Move to the start of this line
        C-e     End     (echo-area-end-of-line)                 Move to the end   of this line

        C-b     Left    (echo-area-backward)                    Move backward a character
        C-f     Right   (echo-area-forward)                     Move forward  a character

        M-b             (echo-area-backward-word)               Move backward a word
        M-f             (echo-area-forward-word)                Move forward  a word

     COMMAND LINE COMPLETIONS
        M-?     ?       (echo-area-possible-completions)        List possible completions
        M-C-v           (echo-area-scroll-completions-window)   Scroll the completions window
        TAB     SPC     (echo-area-complete)                    Insert completion 
        RET     LFD     (echo-area-newline)                     Accept (or force completion of) this line


     DELETE/YANK
        C-d             (echo-area-delete)                      Delete the character under  the cursor
        C-h     DEL     (echo-area-rubout)                      Delete the character behind the cursor

        M-d             (echo-area-kill-word)                   Kill the word following the cursor
        M-DEL           (echo-area-backward-kill-word)          Kill the word preceding the cursor

        C-k             (echo-area-kill-line)                   Kill to the end       of the line
        C-x DEL         (echo-area-backward-kill-line)          Kill to the beginning of the line

        C-y             (echo-area-yank)                        Yank back the contents of the last kill
        M-y             (echo-area-yank-pop)                    Yank back a previous kill


     INSERT
        C-q             (echo-area-quoted-insert)               Insert next  character verbatim
        M-TAB           (echo-area-tab-insert)                  Insert a TAB character


     TRANSPOSE
        C-t             (echo-area-transpose-chars)             Transpose characters at point (and move ahead by one)

     NUMERIC ARGUMENTS ???
        C-u             (universal-argument)                    Start (or multiply by 4) the current numeric argument
        M--             (add-digit-to-numeric-arg)              Add this digit to the current numeric argument
        M-0 .. M-9      (add-digit-to-numeric-arg)              Add this digit to the current numeric argument

        C-x o           (next-window)                           Select the next window