Blame Automation/Manuals/tcar_checkRepoDirSource.sh.asciidoc

Alain Reguera Delgado 8ea9a9
tcar_checkRepoDirSource.sh(1)
Alain Reguera Delgado 8ea9a9
=============================
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
== Name
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
tcar_checkRepoDirSource - Standardize the working copy's absolute path
Alain Reguera Delgado 8ea9a9
construction.
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
== Synopsis
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
tcar_checkRepoDirSource "LOCATION"
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
== Description
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
The *tcar_checkRepoDirSource* function standardizes the path
Alain Reguera Delgado 8ea9a9
construction to directories inside it the working copy, using absolute
Alain Reguera Delgado 8ea9a9
paths.  This function transforms relative paths passed as non-option
Alain Reguera Delgado 8ea9a9
arguments to *centos-art.sh* script command-line into absolute paths
Alain Reguera Delgado 8ea9a9
inside the working copy and verifies whether they really exist as
Alain Reguera Delgado 8ea9a9
directories inside the working copy or not. If the path provided
Alain Reguera Delgado 8ea9a9
doesn't exist as directory inside the working copy, the script will
Alain Reguera Delgado 8ea9a9
finish its execution immediately with an error message. Otherwise, if
Alain Reguera Delgado 8ea9a9
the directory exists, the variable +TCAR_ARGUMENTS+ is redefined with
Alain Reguera Delgado 8ea9a9
the related absolute path for further use.
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
Use the *tcar_checkRepoDirSource* function whenever you need to be
Alain Reguera Delgado 8ea9a9
sure that non-option arguments passed to *centos-art.sh* script
Alain Reguera Delgado 8ea9a9
command-line will always point to directories inside the working copy.
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
== Bugs
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
See https://centos.org.cu/bugs/
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
== Authors
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
The *tcar_checkRepoDirSource* function has received contributions from
Alain Reguera Delgado 8ea9a9
the following people:
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
- Alain Reguera Delgado <al@centos.org.cu>, =COPYRIGHT_YEAR_LIST=
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
== License
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
Copyright (C) =COPYRIGHT_YEAR_LIST= =COPYRIGHT_HOLDER=
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
This program is free software; you can redistribute it and/or modify
Alain Reguera Delgado 8ea9a9
it under the terms of the GNU General Public License as published by
Alain Reguera Delgado 8ea9a9
the Free Software Foundation; either version 2 of the License, or (at
Alain Reguera Delgado 8ea9a9
your option) any later version.
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
This program is distributed in the hope that it will be useful, but
Alain Reguera Delgado 8ea9a9
WITHOUT ANY WARRANTY; without even the implied warranty of
Alain Reguera Delgado 8ea9a9
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Alain Reguera Delgado 8ea9a9
General Public License for more details.
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
You should have received a copy of the GNU General Public License
Alain Reguera Delgado 8ea9a9
along with this program; if not, write to the Free Software
Alain Reguera Delgado 8ea9a9
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
Alain Reguera Delgado 8ea9a9
Alain Reguera Delgado 8ea9a9
// vim: set syntax=asciidoc: