LINUX.ORG.RU — Русская информация об ОС Linux

[#]  
quickquest

Какой стиль комментариев Вы считаете удачным?

// C++ 412
 ********************
/* C */ 328
 ***************
# Python 291
 **************
No comment 67
 ***
;; Lisp 42
 **
{ Delphi } 29
 *
' Visual Basic 29
 *
; Assembler 28
 *
Другой 28
 *
-- Ada 23
 *
! Fortran 10
 *
(* Pascal *) 4
 *
\ Forth 2
 *
" Smalltalk " 0
 *
Всего голосов: 1293

>>> Проголосовать

quickquest ***** (21.07.2008 20:33:55)
Проверено: Shaman007 (25.07.2008 12:28:48)
Juick

[#]  
INFOMAN

Re: Какой стиль комментариев Вы считаете удачным?

А где вариант "Пофиг, лишь бы работало"?

INFOMAN *** (25.07.2008 16:05:47)
fpga

Re: Какой стиль комментариев Вы считаете удачным?

>Сколько?

"//" и "/**/" - (либо один из вариантов либо оба сразу) используется в C, C++, Java, Delphi, HLSL, Cg, Verilog - это только те что я сам знаю, а так встречал такие стили комментирования и во многих других языках... Хотя че ты привязался к словам - откуда я знаю сколько, просто больше, "--", "#" и ";" - тоже часто встречаются :)

fpga (25.07.2008 16:17:40)
[#]  
mic

Re: Какой стиль комментариев Вы считаете удачным?

с отчётливыми и внятными комментариями

mic ***** (25.07.2008 16:19:36)
[#] Ответ на: Re: Какой стиль комментариев Вы считаете удачным? от dev-random 25.07.2008 16:02:30  

Re: Какой стиль комментариев Вы считаете удачным?

> +1. Даёт неограниченный уровень вложенности.

D тоже умеет. :)

/+ +/

naryl *** (25.07.2008 16:42:16)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

Самый удачный стиль комментариев - как в Literate Haskell. Комментарий - это любая нормальная строка, а код должен начинаться с '>'.

Комментариев то по любому должно быть в несколько раз больше, чем кода.

anonymous (25.07.2008 16:46:39)
[#]  
jet_bird

Re: Какой стиль комментариев Вы считаете удачным?

в Ди предусмотрены вложенные комментарии /+ +/

jet_bird * (25.07.2008 17:12:17)
[#]  
Demon37

Re: Какой стиль комментариев Вы считаете удачным?

однострочный -- //

многострочный -- /* */

Demon37 **** (25.07.2008 17:33:45)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

//

/* */

anonymous (25.07.2008 18:44:31)
[#] Ответ на: Re: Какой стиль комментариев Вы считаете удачным? от dev-random 25.07.2008 16:02:30  

Re: Какой стиль комментариев Вы считаете удачным?

> >--[===[ >lua! ;) >--]===[

напоминает разорванный баян. Случайность ?

anonymous (25.07.2008 18:55:58)

Re: Какой стиль комментариев Вы считаете удачным?

> Вообще, ' - это не VB, это просто Basic.

просто бейсик - REM, в школу на повторный курс

anonymous (25.07.2008 19:40:50)
enby

Re: Какой стиль комментариев Вы считаете удачным?

> User line breaks w/quoting

убил

// наше фсьо, ну и /* */ для блоков. Вобще хотелось бы чтоб блоки можно было комментировать символами, расположенными близко друг от друг на стандартных раскладках

enby ** (25.07.2008 20:15:20)

Re: Какой стиль комментариев Вы считаете удачным?

В даже древнючем MSX Basic (ага, (c) Microsoft) был и REM и '.

anonymous (25.07.2008 20:48:39)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

/** */

а ещё

//!<

да-да, Doxygen все дела

r_asian ### (25.07.2008 21:37:06)
[#]  
ManMachine

Re: Какой стиль комментариев Вы считаете удачным?

А почему это # Python, а не Shell и не Perl?

ManMachine * (25.07.2008 21:46:46)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

/* */
//
#

erzengel (25.07.2008 21:57:02)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

// C++ и /* C */

grindars (25.07.2008 22:09:39)
[#] Ответ на: Re: Какой стиль комментариев Вы считаете удачным? от ManMachine 25.07.2008 21:46:46  

Re: Какой стиль комментариев Вы считаете удачным?

> А почему это # Python, а не Shell и не Perl?
+1, более Ъ было бы указать perl. А вообще опрос говно и провокация, да

bobrik * (25.07.2008 22:13:11)
[#] Ответ на: Re: Какой стиль комментариев Вы считаете удачным? от ManMachine 25.07.2008 21:46:46  

Re: Какой стиль комментариев Вы считаете удачным?

угу, убило :)))

а еще и tcl



elipse *** (25.07.2008 22:14:04)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

Адский язак Ада. xD

anonymous (25.07.2008 22:15:33)
[#]  
slonotop

Re: Какой стиль комментариев Вы считаете удачным?

! только так не в одном Фортране

slonotop (25.07.2008 22:55:50)
[#]  
AX

Re: Какой стиль комментариев Вы считаете удачным?

//

AX **** (25.07.2008 22:57:09)
Sphinx

Re: Какой стиль комментариев Вы считаете удачным?

А `//!<` это тоже из Докси? `///` же!

Sphinx *** (25.07.2008 23:07:41)

Re: Какой стиль комментариев Вы считаете удачным?

В Фортране вообще-то не '!', а любой непустой символ в первой позиции.

anonymous (25.07.2008 23:10:16)

Re: Какой стиль комментариев Вы считаете удачным?

> Вобще хотелось бы чтоб блоки можно было комментировать символами, расположенными близко друг от друг на стандартных раскладках

Если ты имеешь в виду близкое расположение клавиш, то тебе стоит посмотреть на цифровую клавиатуру

anonymous (26.07.2008 0:42:52)
[#]  
AsphyX

Re: Какой стиль комментариев Вы считаете удачным?

Да, ещё забыл:

G04 ...

Один из диалектов G-code (http://en.wikipedia.org/wiki/G-code)

AsphyX *** (26.07.2008 1:26:30)
[#] Ответ на: Re: Какой стиль комментариев Вы считаете удачным? от Joe_Bishop 25.07.2008 14:36:59  
AsphyX

Re: Какой стиль комментариев Вы считаете удачным?

>Сишные и цепепешные //, имхо, выглядят уродски.

Да всё выглядит уродски, когда не подсвечено :) Экзотический случай см выше. Особенно, если учесть, что G01 - обычно, перемещение инструмента, и всё прочее в том же духе :)

AsphyX *** (26.07.2008 1:28:55)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

/* */ ascii C всегда был мне ближе!

tetsucceed (26.07.2008 1:28:59)

Re: Какой стиль комментариев Вы считаете удачным?

> // и /* */ - форева :) ибо используется в наибольшем числе языков (что кстати удобно, когда все одинаково комментируется)...

Вранье. Учитывая тематику данного чата, стандартным стилем комментария является именно #. Спросите об этом ядро, даже оно считает, что интерпретатор должен указываться в шебанге (#!).

В Limbo, считающемся наследником C, сделали как раз #-комментарии, чтобы он не выделялся из общего системного окружения.

Да и с наибольшим числом языков что-то у вас не получилось. Мне почему-то кажется, что в основном это C-based типа жабы или php.

anonymous (26.07.2008 1:33:01)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

Для однострочных //, для многострочных /* */, а вообще принципы комментирования почти одни и теже и различия не по сути, а в синтаксисе.

gdn * (26.07.2008 1:45:16)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

А вообще, опрос с одной целью: определить процент быдлокодеров из посетителей ЛОР. Результат вполне предсказуем: >80% (C++, C#, Java, Python)

Led ***## (26.07.2008 2:03:37)
[#] Ответ на: Re: Какой стиль комментариев Вы считаете удачным? от dev-random 25.07.2008 16:02:30  

Re: Какой стиль комментариев Вы считаете удачным?

ЛОРовский рулит

lindemidux (26.07.2008 2:07:45)
[#]  
generatorglukoff

Re: Какой стиль комментариев Вы считаете удачным?

/*
 * где-то вот так
 */

generatorglukoff ** (26.07.2008 3:16:44)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

Пиздец опросец. Объём идиотов ответивших на него — хороший показатель состояния портала.

anonymous (26.07.2008 3:31:59)

Re: Какой стиль комментариев Вы считаете удачным?

для коментирования больших блоков кода мой любимый стиль комментов:

#if 0 код #endif

Grindz (26.07.2008 6:44:11)

Re: Какой стиль комментариев Вы считаете удачным?

>Вранье. Учитывая тематику данного чата, стандартным стилем комментария является именно #. Спросите об этом ядро, даже оно считает, что интерпретатор должен указываться в шебанге (#!).

Что там ядро считает ? Оно само написано с комментами вида // /* */

anonymous (26.07.2008 11:12:37)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

/* */
//
#

Dimian * (26.07.2008 12:26:20)
[#]  
ShprotX

Re: Какой стиль комментариев Вы считаете удачным?

// и {}, извините, но мне не по приколу танцевать пальцами по "/" и "*" ради создания комментария.

ShprotX * (26.07.2008 13:16:57)
[#] Ответ на: Re: Какой стиль комментариев Вы считаете удачным? от dev-random 25.07.2008 16:02:30  

Re: Какой стиль комментариев Вы считаете удачным?

# ruby

mamantoha * (26.07.2008 13:30:00)

Re: Какой стиль комментариев Вы считаете удачным?

=begin
комментарий
и другая строка...
=end

mamantoha * (26.07.2008 13:31:26)
[#]  
far_tuna

Re: Какой стиль комментариев Вы считаете удачным?

// для одной строчки и

/* когда строчек много */

far_tuna * (26.07.2008 13:32:18)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

>;; Lisp

В emacs lisp-е комментарий ";"

Burbaka ** (26.07.2008 14:37:47)
[#]  
jtootf

Re: Какой стиль комментариев Вы считаете удачным?

проголосовал за ADA, хотя вообще лучше всего literate исходники. ну и dcostring'и, конечно

jtootf **** (26.07.2008 15:37:47)

Re: Какой стиль комментариев Вы считаете удачным?

> В emacs lisp-е комментарий ";"

с чего ты взял, что это только у elisp'а? в CL комменты тоже начинаяются с первого символа ";" и до конца строки.

В таком случае можно считать, что

# Here is some comment
и
## Here is some comment

…это разные комментарии

anonymous (26.07.2008 19:16:31)
[#]  
soko1

Re: Какой стиль комментариев Вы считаете удачным?

Смотря каков комментарий. Если многострочный, то однозначно /* */, если однострочный, то похер (но привычнее всего #).

soko1 *** (26.07.2008 20:51:32)

Re: Какой стиль комментариев Вы считаете удачным?

Если многострочный, то никаких /* */ не надо. Комментарием должна быть любая строка, кроме той, которая начинается с '>'.

http://www.haskell.org/onlinereport/literate.html

anonymous (26.07.2008 20:57:17)

Re: Какой стиль комментариев Вы считаете удачным?

User line breaks w/quoting

+1

lodin **** (26.07.2008 22:02:23)
[#]  

Re: Какой стиль комментариев Вы считаете удачным?

Ну, вообще-то не только '#', но и /* */, но голосовал за #

Только почему python? Это вообще-то из шелла такая нотация пришла!

lodin **** (26.07.2008 22:03:54)
[#] Ответ на: Re: Какой стиль комментариев Вы считаете удачным? от dev-random 25.07.2008 16:02:30  

Re: Какой стиль комментариев Вы считаете удачным?

откуда тут взялся быдлоделфи?

anonymous (26.07.2008 23:01:04)
[#]  
BioMD

Re: Какой стиль комментариев Вы считаете удачным?

# shell
ну или
# ruby

BioMD (26.07.2008 23:14:37)

Re: Какой стиль комментариев Вы считаете удачным?

>>Вранье. Учитывая тематику данного чата, стандартным стилем комментария является именно #. Спросите об этом ядро, даже оно считает, что интерпретатор должен указываться в шебанге (#!).

> Что там ядро считает ? Оно само написано с комментами вида // /* */

Я про механизм вызова интерпретатора, известный как shebang. (Видели когда-нибудь #!/bin/sh в начале шелл-скрипта?).

Мнение разработчиков ядра, пишущих на C, не обязано совпадать с unix conventions. А я именно про них.

anonymous (26.07.2008 23:44:25)

О Сервере - Правила форума
http://www.linux.org.ru/

Rambler's Top100 Рейтинг@Mail.ru