Kirjoittaja Aihe: Omien ohjelmien help-sivu  (Luettu 65 kertaa)

Snufkin

  • Käyttäjä
  • Viestejä: 469
    • Profiili
Omien ohjelmien help-sivu
« : tänään kello 11:11 »
Moi!

Onko jossain ohjeita, miten tehdään oikeaoppisesti omaan komentoriviohjelmaan --help -toiminto? Onko tuo help vain tekstiä, minkä ohjelma tulostaa --help/h -argumentilla? Vai onko tapana tehdä oma tiedosto tms.?

Entä onko jossain listaus argumenteista, mitä kannattaa käyttää, jotta olisi yhteneväinen muun komentotulkin käytön kanssa?
Xubuntu 22.04 LTS, Fujitsu Lifebook E754

Tomin

  • Palvelimen ylläpitäjä
  • Käyttäjä / moderaattori+
  • Viestejä: 11545
    • Profiili
    • Tomin kotisivut
Vs: Omien ohjelmien help-sivu
« Vastaus #1 : tänään kello 19:41 »
Millä kielellä olet kirjoittamassa ohjelmaa? Onko käytössä jo joku parseri noille argumenteille? Yleensä sellaista käytettäessä ohjevipu lisätään automaatisesti tai ainakin sille on vakiintunut käytäntö.

Esimerkkejä parsereista Pythonista ja Rustista. Nuo lisäävät ohjeen automaattisesti. C-kielellä voi käyttää getoptia, jolla se parsittaisiin ihan kuten muutkin argumentit, mutta arvon asettamisen sijaan tulostetaan ohje ja poistutaan.

Yleisiä ohjeita argumenteista löytyy vaikkapa täältä: https://www.gnu.org/software/libc/manual/html_node/Argument-Syntax.html
Ja jossain olen nähnyt myös listan tyypillisistä merkityksistä kirjaimille. Laitan tähän, jos löydän sen.
« Viimeksi muokattu: tänään kello 19:46 kirjoittanut Tomin »
Automaattinen allekirjoitus:
Lisäisitkö [RATKAISTU] ketjun ensimmäisen viestin aiheeseen ongelman ratkettua, kiitos.

Snufkin

  • Käyttäjä
  • Viestejä: 469
    • Profiili
Vs: Omien ohjelmien help-sivu
« Vastaus #2 : tänään kello 20:28 »
Millä kielellä olet kirjoittamassa ohjelmaa? Onko käytössä jo joku parseri noille argumenteille? Yleensä sellaista käytettäessä ohjevipu lisätään automaatisesti tai ainakin sille on vakiintunut käytäntö.

Varmaan englanniksi, kun tässä on samalla hieman alan opiskelua mukana. Suomen kieli ei liene kovin laajassa käytössä. Jostain syystä tämä dokumentaatiopuoli loistaa poissaolollaan lähes kaikilla ohjelmointikursseilla.  Ainoastaan Docstring on ollut jollain kurssilla.

Nuo parserit mulle ihan uutta. Varmaan juuri tuota hain, mutta pitää hieman perehtyä noihin.
Xubuntu 22.04 LTS, Fujitsu Lifebook E754

Tomin

  • Palvelimen ylläpitäjä
  • Käyttäjä / moderaattori+
  • Viestejä: 11545
    • Profiili
    • Tomin kotisivut
Vs: Omien ohjelmien help-sivu
« Vastaus #3 : tänään kello 20:30 »
Varmaan englanniksi, kun tässä on samalla hieman alan opiskelua mukana. Suomen kieli ei liene kovin laajassa käytössä.

Tarkoitin ohjelmointikieltä. Eri kielille on omat kirjastonsa tähän tarkoitukseen.
Automaattinen allekirjoitus:
Lisäisitkö [RATKAISTU] ketjun ensimmäisen viestin aiheeseen ongelman ratkettua, kiitos.

Snufkin

  • Käyttäjä
  • Viestejä: 469
    • Profiili
Vs: Omien ohjelmien help-sivu
« Vastaus #4 : tänään kello 20:33 »
Varmaan englanniksi, kun tässä on samalla hieman alan opiskelua mukana. Suomen kieli ei liene kovin laajassa käytössä.

Tarkoitin ohjelmointikieltä. Eri kielille on omat kirjastonsa tähän tarkoitukseen.

C ja Python nyt opiskelussa. Varmaan C:llä teen aluksi noita komentoriviohjelmia. C++ -perusteet kanssa jo jotenkin hallussa.

Nuo laittamasi ovat hyviä linkkejä, kiitos. Perehdyn niihin.
« Viimeksi muokattu: tänään kello 20:42 kirjoittanut Snufkin »
Xubuntu 22.04 LTS, Fujitsu Lifebook E754