Erlang เป็นอีกภาษาที่ทีมพัฒนาเขียน document เอาไว้ดีมากๆ มีให้ทั้งเป็น manpage, html, pdf และ chunks ที่เรียกดูได้จาก erl
ทีนี้ผมใช้ asdf เป็นเครื่องมือในการติดตั้ง Erlang ซึ่งจะไปใช้ kerl อีกที แล้วถ้าอยากให้มันติดตั้ง document ให้ด้วยต้องใส่ env ให้ถูกต้อง
แต่ว่าในหน้า README ของ asdf erlang plugin กับ kerl ดันบอกว่าให้ใส่แค่ env ตัวเดึยวคือตัวนี้
export KERL_BUILD_DOCS=yes
แต่ลองแล้วก็ไม่เห็นจะได้ document แบบ manpage, html, pdf มาเลย แต่เจอว่าใช้งานผ่าน erl ได้
สุดท้ายไล่ดูโค้ดของ asdf erlang plugin กับ kerl จนเจอว่ามันต้องระบุประเภทของ format ของ document ด้วยผ่านอีก env คือ
export KERL_DOC_TARGETS="man html pdf chunks"
ซึ่งใส่หลาย format ได้
เท่านี้ก็ลง Erlang ผ่าน asdf แล้วได้ document ครบทุกประเภทแล้ว
Top comments (0)