วิธีอ่าน 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>
ก็ความหมายเดียวกันกับตัวอย่างบนหนะแหละคือ ให้เลือกใช้สักบรรทัด ไม่ใช่ว่าจะผสมคำสั่งกันได้ทั้งหมด
ประมาณนี้ มีคำถาม คำแนะนำติชม โพสเข้ามาได้เลยครับ