файлы readme и комменты в скриптах

Discussion in 'PHP' started by Дикс, 3 Mar 2008.

  1. Дикс

    Дикс Elder - Старейшина

    Joined:
    16 Apr 2006
    Messages:
    1,194
    Likes Received:
    227
    Reputations:
    26
    Может кто-нить меня просветить на тему составления комментов в скриптах? Ну я о тех шапках, которые вставляются в каждый скрипт, по типу

    PHP:
    /*======================================================================*\
    || #################################################################### ||
    || # vBulletin 3.6.8 Patch Level 1 - Licence Number VBFB92785D
    || # ---------------------------------------------------------------- # ||
    || # Copyright ©2000-2007 Jelsoft Enterprises Ltd. All Rights Reserved. ||
    || # This file may not be redistributed in whole or significant part. # ||
    || # ---------------- VBULLETIN IS NOT FREE SOFTWARE ---------------- # ||
    || # http://www.vbulletin.com | http://www.vbulletin.com/license.html # ||
    || #################################################################### ||
    \*======================================================================*/
    и футер

    PHP:
    /*======================================================================*\
    || ####################################################################
    || # Downloaded: 05:05, Sun Oct 28th 2007
    || # CVS: $RCSfile$ - $Revision: 15988 $
    || ####################################################################
    \*======================================================================*/
    в частности, меня интересует назначение знаков доллара
    што эт за разметка хитрая? она для каких-то парсеров?
    зачем нужно писать "$id" ?
     
  2. spider-intruder

    spider-intruder Elder - Старейшина

    Joined:
    9 Dec 2005
    Messages:
    700
    Likes Received:
    339
    Reputations:
    37
    В принципе не для чего - хотя возможна автор изменяет некоторые значения в коментах парсером и юзает для этого спецсимвол - в даном случае доллар

    Возможно автор написал скрипт который заменяет версию билда во всех коментах. Он знает, что первым в коментах идет версия скрипта

    Делает Explode и заменяет даные на другие
     
    #2 spider-intruder, 3 Mar 2008
    Last edited: 3 Mar 2008
  3. Noiro

    Noiro Banned

    Joined:
    1 Jan 2008
    Messages:
    47
    Likes Received:
    16
    Reputations:
    5
    $Id$ и прочее - это keywords систем контроля версий.
    При коммитте они автоматически делают замену. В часности $Id$ включает в себя номер ревизии, дату коммитта, и автора в Subversion.
     
  4. Дикс

    Дикс Elder - Старейшина

    Joined:
    16 Apr 2006
    Messages:
    1,194
    Likes Received:
    227
    Reputations:
    26
    спасибо