Erlang a komentáře

[Nekdo]

Ahoj, není mi zcela jasný rozdíl mezi těmito druhy komentářů:
% ...
%% ...
%%% ...

Díky za vysvětlení.

[Reklama]

[Jakub L.]

žádný (kromě počtu znaků)

5.3  Comments

Comments may be placed anywhere in a module except within strings and quoted atoms. The comment begins with the character "%", continues up to, but does not include the next end-of-line, and has no effect. Note that the terminating end-of-line has the effect of white space.

[Nekdo]

Why are there multiple percent signs at the start of the line? The Erlang Emacs mode
and many other Erlang tools expect the number of percent signs to indicate levels of
indentation. Three percent signs (%%%) means that the comment will be formatted flush
left, two percent signs (%%) means the comment is indented with surrounding code, and
a single percent sign (%) is used for comments on the end of a line

Citace z knihy Introducing Erlang by Simon St. Laurent

Asi si to špatně překládám, ale nechápu výklad tří a dvou za sebou jdoucích procent.

[dl]

Neznám dobře Emacs ani Erlang, ale podle mne jde jen o konvenci a formátování pomáhá Emacsu, tak i vám rozeznat druh komentáře. Podobně to má Scheme, tam je počet znaků pro komentář také konvence.

http://stackoverflow.com/questions/8255439/commenting-code-in-scheme

[eMko]

Why are there multiple percent signs at the start of the line? The Erlang Emacs mode
and many other Erlang tools expect the number of percent signs to indicate levels of
indentation. Three percent signs (%%%) means that the comment will be formatted flush
left, two percent signs (%%) means the comment is indented with surrounding code, and
a single percent sign (%) is used for comments on the end of a line

Citace z knihy Introducing Erlang by Simon St. Laurent

Asi si to špatně překládám, ale nechápu výklad tří a dvou za sebou jdoucích procent.

"Proč se vyskytuje více znaků % na začátku řádku? Mód pro Erlang v Emacsu a mohé jiné nástroje pro Erlang předpokládají, že počet znaků % bude korespondovat s úrovní odsazení. Tři znaky znamenají, že komentář bude zarovnán vlevo, 2 znaky, že bude zarovnán s okolním kódem a jeden znak bude použit pro komentář na konci kódu."

pravděpodobně je to myšleno takto


%%% Komentář zarovnán vlevo
class aFirstClass {
     %% komentář k funkci
     private viod someFunction(int* a) {
          if (null == a) {
               return; %tuto konstrukci v Erlangu nepotkáte
     }
}

[Reklama]

[eMko]

sorry, mám tam překlep "a jeden znak bude použit pro komentář na konci řádku"

[Nekdo]

Dobrá, ale mám chápat, že mód Erlangu v Emacsu sám komentáře zarovná podle počtu % nebo je to jen úmluva ?

[eMko]

Očekával bych, že je skutečně zarovná sám, ale nevím to - musíš se podívat do dokumentace k tomu pluginu nebo to vyzkoušet.

Erlang neznám, stejně tak neznám plugin pro Erlang do Emacsu (a ze znalosti pluginu pro Common Lisp zde bohužel vyjít nelze; pravděpodobně budou jiné). V tom textu je použito slovo "expect", tedy to ukazuje pouze na úmluvu - nic víc ani míň z toho nevyplývá.

[Nekdo]

Díky všem za rady, můžete zamknout.