(no subject)

[nataraj]

Конвертирую очередную книгу в fb2 чтобы нормально почитать... Откусываю шапку дизайна... Случайно заглянул во внутрь. Там написано:

<SCRIPT LANGUAGE="JavaScript">
document.ondragstart = test;
//запрет на перетаскивание
document.onselectstart = test;
//запрет на выделение элементов страницы
document.oncontextmenu = test;
//запрет на выведение контекстного меню
function test() {
return false
}
</SCRIPT>

Задумался о вечном...

Я ведь даже не заметил что мне что-то запретили...

Comments

[slobin.livejournal.com]

Ну да. Я свой код комментирую именно по этой причине. А ты нет?

... Новая кожа змеи повторяет узор вековечный ...

[shaplov.livejournal.com]

Я стараюсь писать код так, чтобы потом его можно было понять без комментариев. В 80% случаев мне это удается (в смысле написать).
Исключения бывают со всякими неизящными конструкциями вроде XML-DOM и пр...

[slobin.livejournal.com]

Ну да, я не комментирую, как эти гении, каждую строчку. Код очевиден сам по себе. ;-) Но перед каждым большим блоком кода (обычно функцией, но это не догма -- он может оказаться и больше, и меньше) идёт комментарий, что этот блок делает и зачем он нужен. Примерно то, что я бы написал в хелпе по этой функции.

... Зимой можно смелее учиться летать ...

[shaplov.livejournal.com]

Вообщем да...
Хотя к функции RemoveTabs, принимающей и возвращающий строку, писать комментарий как-то излишне...

[slobin.livejournal.com]

Всякое бывает. С одной стороны, перед вот таким я комментарий писать не стал:

function xpath(query, root, type)
{
    return document.evaluate(query, root, null, type, null);
}

С другой стороны, перед вот таким -- стал:

" Choose an icon for the statusline, depending on three status bits
function! Icon()
  return g:icons[exists("g:syntax_on") * 4 + &spell * 2 + &wrap]
endfunction

В чём разница? А хрен её знает, товарищ начальник...

... И на "е" бывает, и на "ё" бывает ...

[shaplov.livejournal.com]

Ну почему, все логично...
В обоих случаях по имени функции нельзя понять что происходит.

Но в первом случае становиться понятно что именно происходит просто бегло посмотрев код. А вот во втором случае, без знания контекста применения я бы не в жизнь не догадался что именно функция делает.