* HACKING (Editing `.m4sh' Files): Document preferred function

header layout.
* config/ltmain.m4sh (func_win32_libid, func_infer_tag)
(func_generate_dlsyms, func_extract_an_archive, func_extract_archives):
adjust to fit.
This commit is contained in:
Ralf Wildenhues 2005-02-01 07:34:34 +00:00
parent 62fae08f57
commit 37a552884d
3 changed files with 31 additions and 6 deletions

View File

@ -1,3 +1,11 @@
2005-02-01 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
* HACKING (Editing `.m4sh' Files): Document preferred function
header layout.
* config/ltmain.m4sh (func_win32_libid, func_infer_tag)
(func_generate_dlsyms, func_extract_an_archive, func_extract_archives):
adjust to fit.
2005-01-31 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
* m4/libtool.m4 (_LT_CMD_GLOBAL_SYMBOLS): Unicos 9 sed rejects

14
HACKING
View File

@ -200,7 +200,19 @@ yyyy-mm-dd Name of Author <email@address> (tiny change)
variable names. Don't use `return', instead echo the result of a
function and call it from within backquotes.
* Function names should be prefixed `func_'.
* Function names should be prefixed `func_', the function header should
look like this:
# func_foo [ OPTIONS ]
# Description of what func_foo does and returns.
func_foo ()
{
$opt_debug
# contents of func_foo ...
}
The `$opt_debug' is used to enable shell tracing (Korn shells reset
this on function entry).
* For functions that are called frequently, if you need to return a
value, don't cause unneccessary forking of the shell using echo as

View File

@ -636,7 +636,8 @@ func_ltwrapper_p ()
# Need a lot of goo to handle *both* DLLs and import libs
# Has to be a shell function in order to 'eat' the argument
# that is supplied when $file_magic_command is called.
func_win32_libid () {
func_win32_libid ()
{
$opt_debug
win32_libid_type="unknown"
win32_fileres=`file -L $1 2>/dev/null`
@ -678,7 +679,8 @@ func_win32_libid () {
# Only attempt this if the compiler in the base compile
# command doesn't match the default compiler.
# arg is usually of the form 'gcc ...'
func_infer_tag () {
func_infer_tag ()
{
$opt_debug
if test -n "$available_tags" && test -z "$tagname"; then
CC_quoted=
@ -733,7 +735,8 @@ func_infer_tag () {
# func_generate_dlsyms outputname originator pic_p
# Extract symbols from dlprefiles and create ${outputname}S.o with
# a dlpreopen symbol table.
func_generate_dlsyms () {
func_generate_dlsyms ()
{
$opt_debug
my_outputname="$1"
my_originator="$2"
@ -975,7 +978,8 @@ static const void *lt_preloaded_setup() {
}
# func_extract_an_archive dir oldlib
func_extract_an_archive () {
func_extract_an_archive ()
{
$opt_debug
f_ex_an_ar_dir="$1"; shift
f_ex_an_ar_oldlib="$1"
@ -1012,7 +1016,8 @@ func_extract_an_archive () {
# func_extract_archives gentop oldlib ...
func_extract_archives () {
func_extract_archives ()
{
$opt_debug
my_gentop="$1"; shift
my_oldlibs=${1+"$@"}