Ketika kita menggunakan aplikasi atau software yang belum pernah kita gunakan sebelumnya terkadang kita perlu menyesuaikan dengan interface pada aplikasi tersebut agar dapat menggunakannya. Akan lebih mudah jika aplikasi tersebut memiliki Grafikal interface, akan tetapi jika interfacenya berupa perintah yang perlu ditulis menggunakan teks (command line interface), maka kita akan kesulitan untuk memahami apa saja command untuk menggunakan software tersebut sesuai dengan tujuan kita.

Tapi untungnya di ubuntu terminal (command line interface) menyediakan beberapa cara agar kita dapat mengakses dan membaca paduan tersebut langsung dari terminal.

Menggunakan opsi perintah -h atau –help

Jika kita tidak mengetahui cara menggunakan software tertentu menggunakan command line interface, apa saja opsi dan parameter yang perlu digunakan, maka kita bisa menggunakan opsi -h atau --help dan atau -help.

Untuk menggunakan opsi tersebut, sebelumnya kita perlu menuliskan nama software yang ingin kita gunakan. Misalnya yaitu untuk menggunakan Hugo Static Site Generator kita bisa menampilkan bantuannya dengan menggunakan opsi -h seperti berikut.

> hugo -h
hugo is the main command, used to build your Hugo site.

Hugo is a Fast and Flexible Static Site Generator
built with love by spf13 and friends in Go.

Complete documentation is available at http://gohugo.io/.

Usage:
  hugo [flags]
  hugo [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  config      Print the site configuration
  convert     Convert your content to different formats
  deploy      Deploy your site to a Cloud provider.
  env         Print Hugo version and environment info
  gen         A collection of several useful generators.
  help        Help about any command
  import      Import your site from others.
  list        Listing out various types of content
  mod         Various Hugo Modules helpers.
  new         Create new content for your site
  server      A high performance webserver
  version     Print the version number of Hugo

 [[ ... baris seterusnya disembunyikan ... ]]
Code Snippet 1: Tampilan Hugo Help

Seperti dilihat pada contoh, bantuan menggunakan perintah hugo ditampilkan ketika menggunakan opsi --help. Hampir semua software berbasis command line interface memiliki opsi ini, hanya saja terkadang cara penulisan opsinya agak sedikit berbeda, terkadang ada yang menggunakan penulisan opsi --help, -h atau -help.

Membaca Software Manual Menggunakan Perintah `man`

Jika menggunakan opsi --help kita masih sulit untuk memahami dan menggunakan software tersebut, setiap software command line interface terinstall berserta dengan paduan manualnya. Untuk mengakses paduan manual tersebut kita bisa menggunakan perintah man seperti berikut.

> man hugo
  HUGO(1)                                                                                                 Hugo Manual                                                                                                 HUGO(1)

  NAME
         hugo - hugo builds your site

  SYNOPSIS
         hugo [flags]

  DESCRIPTION
         hugo is the main command, used to build your Hugo site.

         Hugo is a Fast and Flexible Static Site Generator built with love by spf13 and friends in Go.

         Complete documentation is available at http://gohugo.io/.

  OPTIONS
         -b, --baseURL=""      hostname (and path) to the root, e.g. http://spf13.com/

  [[ ---  Baris Teks disembunyikan  --- ]]

         -w, --watch[=false]      watch filesystem for changes and recreate as needed

  SEE ALSO
         hugo-completion(1), hugo-config(1), hugo-convert(1), hugo-deploy(1), hugo-env(1), hugo-gen(1), hugo-import(1), hugo-list(1), hugo-mod(1), hugo-new(1), hugo-server(1), hugo-version(1)

  Hugo 0.92.2
Code Snippet 2: Contoh tampilan manual hugo

Pada contoh - contoh diatas kita bisa melihat perbedaan antara manual dan bantuan --help. Manual lebih mendetail membahas semua cara menggunakan setiap opsi, dan perintah - perintah yang tersedia untuk digunakan.

Setiap software bisa memiliki lebih dari satu halaman paduan manual. Seperti pada contoh diatas, hugo juga memiliki manual untuk completion (hugo-completion), manual untuk konfigurasi hugo (hugo-config) dan seterusnya. Kita bisa menggunakan referensi perintah tersebut untuk membuka manual dengan menggunakan perintah man. Misal untuk melihat cara membuat blog menggunakan hugo, kita bisa melihat di manual hugo-new-site seperti referensi manual diatas.

> man hugo-new-site
  HUGO-NEW-SITE(1)                                                                                        Hugo Manual                                                                                        HUGO-NEW-SITE(1)

  NAME
         hugo-new-site - Create a new site (skeleton)

  SYNOPSIS
         hugo new site [path] [flags]

  DESCRIPTION
         Create a new site in the provided directory.  The new site will have the correct structure, but no content or theme yet.  Use hugo new [contentPath] to create new content.

  OPTIONS
         --force[=false]      init inside non-empty directory

         -f, --format="toml"      config file format

         -h, --help[=false]      help for site

  OPTIONS INHERITED FROM PARENT COMMANDS
         --config=""      config file (default is path/config.yaml|json|toml)

[[ Baris teks seterusnya disembunyikan ]]

Menggunakan perintah `info`

Beberapa software terkadang memiliki halaman manual yang terpisah, seperti contoh sebelumnya hugo memiliki halaman lain untuk membahas perintah tertentu lainnya. Jika kita ingin membaca halaman lainnya maka kita perlu keluar dari halaman tersebut dan menuliskan perintah untuk membuka halaman lainnya. Hal ini tentu sangat sedikit ribet karena kita perlu mengingat nama halaman yang akan dibuka tersebut. Untuk menyederhanakannya kita bisa menggunakan perintah info.

> info xkbevd
  XKBEVD(1)                   General Commands Manual                  XKBEVD(1)

  NAME
         xkbevd - XKB event daemon

  SYNOPSIS
         xkbevd [ options ]

  DESCRIPTION
         This  command  is very raw and is therefore only partially implemented;
         we present it here as a rough prototype for developers, not as  a  gen‐
         eral  purpose  tool  for  end  users.  Something like this might make a
         suitable replacement for xev; I'm not signing up, mind you, but it's an
         interesting idea.

         The  xkbevd  event daemon listens for specified XKB events and executes
         requested commands if they occur.  The configuration file consists of a
         list of event specification/action pairs and/or variable definitions.

[[ --- baris seterusnya disembunyikan ---]]
Code Snippet 3: Contoh halaman paduan xkbevd

Perintah berperilaku layaknya browser untuk menjelajah halaman manual. Kita bisa mengunjugi link ke halaman manual lainnya langsung tanpa harus menuliskan perintah di terminal. Untuk mengarahkan ke link berikutnya kita bisa menggunakan tab pada keyboard, sebaliknya untuk mengarahkan kursor ke link sebelumnya dengan kombinasi tombol shift + tab. Untuk mengunjungi link yang terpilih bisa tekan tombol Enter keyboard.

Perintah info tidak sebatas menjelajah link pada halaman manual. Jika kamu tertarik kamu bisa menekan tombol h untuk menjelajah ke manual penggunaan perintah info. Kamu juga bisa melihat halaman awal info dengan mengetikkan info di terminal dan mulai menjelajah dari sana.

Mencari Manual menggunakan perintah `apropos`

Setiap aplikasi atau software di linux terkadang memiliki ketergantungan terhadap software lain, entah itu software yang berperilaku seperti librari ataupun plugin. Atau bahkan saingan atau alternatif dari software tersebut. Dengan begitu terkadang sebuah halaman manual membahas software lain yang digunakan software tersebut. Perintah apropos memudahkan kita untuk mencari halaman manual yang membahas kata kunci atau nama software tertentu.

> apropos dmenu
dmenu (1)            - dynamic menu
dmenu_path (1)       - find and cache a list of executables
dmenu_run (1)        - dynamic menu
rofi (1)             - A window switcher, application launcher, ssh dialog, dmenu replacement and more

Contoh diatas kata kunci atau nama software dmenu dapat ditemukan pada halaman dmenu itu sendiri dan halaman manual rofi dimana merupakan alternatif dari dmenu.

Apropos bekerja seperti halnya perintah man -k, jadi jika kamu lupa dengan perintah ini kamu bisa menggunakan perintah man -k keyword_atau_nama_aplikasi.

Penutup

Setelah kita mengetahui bagaimana mencari dan membaca paduan dari software atau aplikasi berbasis CLI (Command line interface) yang kamu install di linux sistem, kita bisa sering memanfaatkannya terutama ketika kita tidak memiliki koneksi untuk mencari paduan di internet.

Di linux kita bisa menggunakan info sebagai browser offline kita untuk menjelajah halaman paduan dan apropos atau man -k sebagai mesin pencarinya.