valter/dosbox-staging
1
0
Fork 0
Code Releases Activity

Allow config properties to be deprecated

Browse source 
This allows us to show a warning to the user if the .conf file includes
a property that is no longer supported, or a property that is completely
unknown.  Actual handling of the property can still be implemented
(e.g. to use as a fallback for modern replacement), but doesn't need
to be.
This commit is contained in:
Patryk Obara 2020-03-22 23:30:58 +01:00 • committed by Patryk Obara
parent 779131d396
commit 04d2e9f3f1
3 changed files with 44 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

17
include/setup.h
View file

@ -111,14 +111,20 @@ private:
class Property {
public:
struct Changeable { enum Value {Always, WhenIdle,OnlyAtStart};};
struct Changeable {
enum Value { Always, WhenIdle, OnlyAtStart, Deprecated };
};
const std::string propname;
Property(std::string const& _propname, Changeable::Value when):propname(_propname),change(when) { }
virtual ~Property() = default;
void Set_values(const char * const * in);
void Set_values(const std::vector<std::string> &in);
void Set_help(std::string const& str);
char const* Get_help();
const char* GetHelp() const;
virtual bool SetValue(std::string const& str)=0;
Value const& GetValue() const { return value;}
Value const& Get_Default_Value() const { return default_value; }
@ -126,11 +132,12 @@ public:
//Type specific properties are encouraged to override this and check for type
//specific features.
virtual bool CheckValue(Value const& in, bool warn);
public:
virtual ~Property(){ }
Changeable::Value GetChange() const { return change; }
bool IsDeprecated() const { return (change == Changeable::Value::Deprecated); }
virtual const std::vector<Value>& GetValues() const;
Value::Etype Get_type(){return default_value.type;}
Changeable::Value getChange() {return change;}
protected:
//Set interval value to in or default if in is invalid. force always sets the value.