Dit is de opdracht src2man die kan worden uitgevoerd in de gratis hostingprovider van OnWorks met behulp van een van onze meerdere gratis online werkstations zoals Ubuntu Online, Fedora Online, Windows online emulator of MAC OS online emulator
PROGRAMMA:
NAAM
src2man - extraheer manpagina's uit bronbestanden.
KORTE INHOUD
src2man [-n][-d datum][-v volume][-r los] [srcbestand
PRODUCTBESCHRIJVING
src2man scant het bronbestand srcbestand. Momenteel worden alleen C-bronbestanden ondersteund. Opmerkingen
blokken die beginnen met "/** num", waarbij num een sectienummer is, worden omgezet in een man
bestand, met behulp van txt2man(1).
De eerste regel van het commentaarblok moet de naam van de manpagina bevatten, meestal de
functienaam, gevolgd door een "-" en een korte beschrijving. De volgende regels zijn de
De inhoud van de sectie "BESCHRIJVING", behalve als deze in hoofdletters staat, in welk geval ze definiëren
een nieuwe sectie.
Als de volgende regel na een commentaarblok leeg is, zal er geen sectie "SYNOPSIS" zijn
gegenereerd. Anders, src2man zal in de volgende bronregels zoeken naar een functie
prototype of een typedefinitie (struct, union, typedef, ...) die overeenkomt met de naam van de manpagina, en
neem het op in een sectie "SYNOPSIS". Dit voorkomt dat het type of de functie wordt gedupliceerd
prototype in het commentaarblok.
De beste plaats voor codedocumentatie is in het bronbestand, waar de hoofdtekst zich bevindt
geïmplementeerd, niet het headerbestand dat alleen het prototype bevat. src2man webmaster.
zoekt naar de aanwezigheid van een prototype in het bijbehorende headerbestand en, indien gevonden,
zal een "#include"-instructie afdrukken in de synopsis.
OPTIES
-d gegevens
Stel de datum van de manpagina's in. Standaard ingesteld op de huidige datum.
-n Er wordt geen manpagina aangemaakt. De namen van de manpagina's die aangemaakt zouden worden, worden afgedrukt.
-v volume
Geef de naam op van het volume dat moet worden afgedrukt in de middelste koptekst van het gegenereerde volume
manpagina's.
-r los
Geef de projectnaam op en los nummer voor de gegenereerde manpagina.
VOORBEELD
In het volgende voorbeeld worden C-code en opmerkingen weergegeven om een manpagina foobar.3 te genereren:
/** 3
* foobar - een voorbeeld van een dummy-functie
* Deze regel is nu de eerste van het beschrijvingsgedeelte.
* Merk op dat de functieparameters parm1 en parm2 gemarkeerd zijn
* in de gegenereerde manpagina.
*/
int foobar(char *parm1, int parm2)
{
...
0 terug;
}
Gebruik src2man online met behulp van onworks.net-services
