วิธีอ่าน fast help ของ app ใน command line

บางทีผมโพสคำสั่ง command line ไปแล้วเอาก๊อปปี้แปะเลยโดนที่ไม่เข้าใจ

ยกตัวอย่าง agvtool

agvtool เป็นคำสั่งใช้จัดการ build number, build version ของ Xcode project

$ agvtool
Operation specifier required.
agvtool - Apple-generic versioning tool for Xcode projects
  usage:
    agvtool help
    agvtool what-version | vers [-terse]
    agvtool [-noscm | -usecvs | -usesvn] next-version | bump [-all]
    agvtool [-noscm | -usecvs | -usesvn] new-version [-all] <versNum>
    agvtool [-noscm | -usecvs | -usesvn] tag [-force | -F] [-noupdatecheck | -Q] [-baseurlfortag]
    agvtool what-marketing-version | mvers [-terse | -terse1]
    agvtool [-noscm | -usecvs | -usesvn] new-marketing-version <versString>

คือผมพิมพ์ agvtool ไปแล้วมันบอกว่า Operation specifier required. คือช่วยระบุด้วยว่าจะให้ agvtool ทำอะไร

แล้วมันก็ยกตัวอย่างคำสั่งมาให้ จะเห็นว่ามีสัญลักษณ์ ต่าง ๆ

• ไปป์ | แปลว่าให้เลือกคำสั่งใดคำสั่งนึง
• สแควร์แบรคเคร็ด [] แปลว่าใส่ก็ได้ไม่ใส่ก็ได้ ไม่ได้บังคับ (เป็น optional)

เพราะฉนั้นถ้าเจอ [-force | -F] คือเลือก -force หรือ -F ก็ได้ หรือไม่ต้องใส่เลยก็ได้ เพราะอยู่ใน [] และมี option ให้เลือก

ใน [] อาจจะเป็นคำสั่งเดียวกันเขียนได้ทั้งสองแบบโดยเลือกอย่างใดอย่างหนึ่ง หรือ อาจจะคนละความหมายกันก็ได้ เช่น git merge [--no-ff | --ff] (แต่ใน docs จริง ๆ มันเขียนว่า git merge [--[no-]ff])

• แองเกิลแบรคเคร็ด <> แปลว่าบังคับใส่ อาจจะเป็นค่าที่บอกที่อยู่ข้างใน หรืออาจจะหมายถึงค่าอื่น ๆ ที่ระบุเองก็ได้
• ไม่อยู่ใน [] หรือ <> แปลว่าบังคับใส่ละไม่ได้ ระบุเองไม่ได้ต้องเขียนตามนั้น

บางครั้งอาจเจอตัวอย่างแบบนี้

agvtool help
        what-version | vers [-terse]
        [-noscm | -usecvs | -usesvn] next-version | bump [-all]
        [-noscm | -usecvs | -usesvn] new-version [-all] <versNum>
        [-noscm | -usecvs | -usesvn] tag [-force | -F] [-noupdatecheck | -Q] [-baseurlfortag]
        what-marketing-version | mvers [-terse | -terse1]
        [-noscm | -usecvs | -usesvn] new-marketing-version <versString>

ก็ความหมายเดียวกันกับตัวอย่างบนหนะแหละคือ ให้เลือกใช้สักบรรทัด ไม่ใช่ว่าจะผสมคำสั่งกันได้ทั้งหมด

ประมาณนี้ มีคำถาม คำแนะนำติชม โพสเข้ามาได้เลยครับ