$Id$
This document descirbe format
format on server
format for perl tools
Description:
=============================

=========================
 Global settings:
 This apply on all lists
=========================

//
#
Comments, ignore line

:getfromurl=NAME:URL
[N/A]
retrieve list from URL for site NAME, NAME is only an identifier

TEXT in motd.txt file
::motd:N:TEXT
TEXT is motd, news to show, N is number of line

:source=NAME:DESC
::source:NAME:DESC
Description for media NAME

:urpmiopt=NAME:OPTIONS
::urpmiopt:NAME:OPTIONS
Options for urpmi

:is_sure=NAME:yes
::is_sure:NAME:yes
Source Name is full supported by mandrake, else perl tools do not show it by default

:minor=NAME:yes
::minor:NAME:yes
Source NAME is not important, then do not show by default

:s_url=NAME:URL
::s_url:NAME:URL
Url for source NAME, informative info 

:location=HOSTNAME:LOCATION
[N/A] (put on each line)
LOCATION for mirror named HOSTNAME, only FQDN, do not set protocol

=================================
 Lists settings:
 Apply only for the current file
=================================

arch=ARCH
[N/A]
Default arch for the whole file

vers=MDKVER
[N/A]
Default Mandrake version for the whole file

name=NAME
[N/A]
Default name for the whole file

=============================================
 Real list
 Should be after a [SECTION] within the file
=============================================

NAME:MDKVER:ARCH:LOCATION:URL_WITH_HDLIST
NAME:MDKVER:ARCH:LOCATION:URL_WITH_HDLIST

====================================
 Macros:
 On source list, you can use macros
====================================

MACROS=VALUE setup a macros, only apply on the current files
'name',  'vers' and 'arch' are reserve keyword, see bellow

LOCATION is optional, can be find on global option
NAME,MDKVER,ARCH can set on global option, then put '$'
NAME,MDKVER,ARCH can notice some entry, separate by '|'

URL_WITH_HDLIST can contain macros:
$(KEYWORD), KEYWORD is 'name', 'vers' or 'arch', take value from current line
${MACROS} to use macros