Unclearity in file gadgets/getfile.h

Report errors, omissions, etc. regarding the AmigaOS Documentation Wiki here.
Post Reply
User avatar
OldFart
Posts: 104
Joined: Tue Jul 12, 2011 2:56 pm
Location: Groningen, Netherlands

Unclearity in file gadgets/getfile.h

Post by OldFart »

Hi,

In this file the tags for said gadget are defined, however a few relatively recently added ones feel a bit incomplete

Code: Select all

# define GETFILE_FilePartOnly            (GETFILE_Dummy+23)
    /* (BOOL) display file part only - valid ONLY in readonly mode! */

Code: Select all

# define GETFILE_InitialShowVolumes      (GETFILE_Dummy+26)
    /* (BOOL) Show volumes initially. (V53.10) */
What are the default values here?

** EDIT: **
The AutoDocs on this subject state the following:

Code: Select all

	GETFILE_FilePartOnly (BOOL)
	    Return the file part only when in read only mode.

	    Defaults to FALSE.

	    Applicability is (OM_NEW, OM_SET)
So THAT one is solved, but hey the AutoDocs make no mention of the the final 2 tags as mentioned in the header file:

Code: Select all

GETFILE_FilterHook

Code: Select all

GETFILE_InitialShowVolumes
OldFart
X5000, appears to be sick. Dismantled jan 1, 2024.
Dead MicroA1
A1200 in ElBox, c/w Blizzard '040 @ 50MHz + SCSI module, ZIV-board c/w (o.a.) cv64/3d + flickerdoubler + FastATA-ZIV + Lots of SCSI gear, sitting idle.
RaspBerry Pi 2B, 3B, 4B/4Gb, 4B/8Gb
OrangePi 5+ 8Gb
ACER Windows 10
User avatar
nbache
Beta Tester
Beta Tester
Posts: 1728
Joined: Mon Dec 20, 2010 7:25 pm
Location: Copenhagen, Denmark
Contact:

Re: Unclearity in file gadgets/getfile.h

Post by nbache »

What version of the SDK do you have? Both tags are documented in my SDK 54.16, and even in an older SDK 53.29 I had lying around.

Best regards,

Niels
User avatar
OldFart
Posts: 104
Joined: Tue Jul 12, 2011 2:56 pm
Location: Groningen, Netherlands

Re: Unclearity in file gadgets/getfile.h

Post by OldFart »

@nbache

This snippet is from the headerfile in question:

Code: Select all

/*
**    $VER: getfile.h 53.29 (10.8.2015)
**
**    Definitions for the getfile.gadget BOOPSI class
**
**    Copyright (C) 1985-2005 Hyperion Entertainment VOF and Amiga, Inc.
**        All Rights Reserved
**
**    Copyright (c) 2010 Hyperion Entertainment CVBA.
**        All Rights Reserved.
*/
EDIT:
I'm sorry for the inconvenience. Switched to the latest version now...

The AutoDocs on the subject is the online version (which, in my opinion, is horrendously organised).

OldFart
Last edited by OldFart on Thu Aug 08, 2024 11:16 am, edited 1 time in total.
X5000, appears to be sick. Dismantled jan 1, 2024.
Dead MicroA1
A1200 in ElBox, c/w Blizzard '040 @ 50MHz + SCSI module, ZIV-board c/w (o.a.) cv64/3d + flickerdoubler + FastATA-ZIV + Lots of SCSI gear, sitting idle.
RaspBerry Pi 2B, 3B, 4B/4Gb, 4B/8Gb
OrangePi 5+ 8Gb
ACER Windows 10
User avatar
nbache
Beta Tester
Beta Tester
Posts: 1728
Joined: Mon Dec 20, 2010 7:25 pm
Location: Copenhagen, Denmark
Contact:

Re: Unclearity in file gadgets/getfile.h

Post by nbache »

Hmm - I'm not sure who, if anybody, is maintaining the Wiki copy of those docs.

I'd suggest always referring to the SDK in the latest available version, if in doubt.

Best regards,

Niels
Post Reply