Rel. path in paths prefs preserved as rel. paths

Before this commit, in the paths preferences tab if you put a
relative path, LyX would convert it behind the scenes to an absolute
path by evaluating the relative path with respect to the working
directory of the LyX instance where the preference change is taking
place. This seems confusing because (1) it is done behind the scenes
(after the preferences dialog is closed) and (2) if the user chooses
to enter a relative path, the safest thing to do is to preserve it
as a relative path, instead of making the assumption that the user
intended for it to be expanded to an absolute path.

An explanation of how relative paths are handled is given at the
bottom of the paths tab. Note that the height/width of the
preferences window is not changed as a result of adding this
explanatory comment because the height of the preferences dialog is
already stretched by other tabs.

This commit improves consistency in the sense that the behavior of
LyX is now the same when a relative path is specified in the
preferences dialog as when it is manually specified in the
preferences file. Before, if the preferences file were manually
edited and a relative path were inserted, the next time the user
made a change to preferences with the GUI (even if the preference
change was a different preference, e.g. instant preview), the
relative path would be silently converted to an absolute path,
evaluated with respect to the working directory of that instance.

Beyond improving clarity and consistency (IMO), this commit allows
for a new feature to be implemented of using relative paths in the
paths preferences. For example, the user may now enter '.' as the
"Working directory" path and now whenever they start LyX from a
directory and create a new file, the default location of the file
will be the directory from which they started LyX, instead of the
user's home directory which is LyX's default and is less intuitive.

No prefs2prefs work is needed because if a relative path were
entered in the preferences dialog before this commit, it was
converted to an absolute path before being stored in preferences. If
a relative path were specified by manually editing the preferences
file, then (unless the path were already automatically converted to
an absolute path by a GUI preferences change, as described above)
the behavior will be the same (the path will be treated as a
relative path).

For related discussion, see the lyx-devel thread here:
https://www.mail-archive.com/search?l=mid&q=20160616003010.bnymtcouar7g55ti%40cotopaxi

This commit removes the last use of lyx::support::expandPath() in
LyX's sources.
This commit is contained in:
Scott Kostyshak 2016-07-29 13:13:55 -04:00
parent 60e8921349
commit 9b64d7bd24
2 changed files with 15 additions and 37 deletions

View File

@ -634,45 +634,33 @@ LyXRC::ReturnValues LyXRC::read(Lexer & lexrc, bool check_format)
break; break;
case RC_DOCUMENTPATH: case RC_DOCUMENTPATH:
if (lexrc.next()) { if (lexrc.next())
document_path = os::internal_path(lexrc.getString()); document_path = os::internal_path(lexrc.getString());
document_path = expandPath(document_path);
}
break; break;
case RC_EXAMPLEPATH: case RC_EXAMPLEPATH:
if (lexrc.next()) { if (lexrc.next())
example_path = os::internal_path(lexrc.getString()); example_path = os::internal_path(lexrc.getString());
example_path = expandPath(example_path);
}
break; break;
case RC_TEMPLATEPATH: case RC_TEMPLATEPATH:
if (lexrc.next()) { if (lexrc.next())
template_path = os::internal_path(lexrc.getString()); template_path = os::internal_path(lexrc.getString());
template_path = expandPath(template_path);
}
break; break;
case RC_TEMPDIRPATH: case RC_TEMPDIRPATH:
if (lexrc.next()) { if (lexrc.next())
tempdir_path = os::internal_path(lexrc.getString()); tempdir_path = os::internal_path(lexrc.getString());
tempdir_path = expandPath(tempdir_path);
}
break; break;
case RC_THESAURUSDIRPATH: case RC_THESAURUSDIRPATH:
if (lexrc.next()) { if (lexrc.next())
thesaurusdir_path = os::internal_path(lexrc.getString()); thesaurusdir_path = os::internal_path(lexrc.getString());
thesaurusdir_path = expandPath(thesaurusdir_path);
}
break; break;
case RC_HUNSPELLDIR_PATH: case RC_HUNSPELLDIR_PATH:
if (lexrc.next()) { if (lexrc.next())
hunspelldir_path = os::internal_path(lexrc.getString()); hunspelldir_path = os::internal_path(lexrc.getString());
hunspelldir_path = expandPath(hunspelldir_path);
}
break; break;
case RC_USELASTFILEPOS: case RC_USELASTFILEPOS:
@ -813,10 +801,8 @@ LyXRC::ReturnValues LyXRC::read(Lexer & lexrc, bool check_format)
break; break;
case RC_SERVERPIPE: case RC_SERVERPIPE:
if (lexrc.next()) { if (lexrc.next())
lyxpipes = os::internal_path(lexrc.getString()); lyxpipes = os::internal_path(lexrc.getString());
lyxpipes = expandPath(lyxpipes);
}
break; break;
case RC_CURSOR_FOLLOWS_SCROLLBAR: case RC_CURSOR_FOLLOWS_SCROLLBAR:
@ -901,10 +887,8 @@ LyXRC::ReturnValues LyXRC::read(Lexer & lexrc, bool check_format)
lexrc >> save_origin; lexrc >> save_origin;
break; break;
case RC_BACKUPDIR_PATH: case RC_BACKUPDIR_PATH:
if (lexrc.next()) { if (lexrc.next())
backupdir_path = os::internal_path(lexrc.getString()); backupdir_path = os::internal_path(lexrc.getString());
backupdir_path = expandPath(backupdir_path);
}
break; break;
case RC_DEFAULT_DECIMAL_POINT: case RC_DEFAULT_DECIMAL_POINT:
lexrc >> default_decimal_point; lexrc >> default_decimal_point;

View File

@ -20,20 +20,14 @@
<number>6</number> <number>6</number>
</property> </property>
<item row="12" column="0" colspan="3" > <item row="12" column="0" colspan="3" >
<spacer> <widget class="QLabel" name="label">
<property name="orientation" > <property name="text">
<enum>Qt::Vertical</enum> <string>Relative and absolute paths are allowed. Relative paths will be expanded with respect to the working directory (WD). For all paths except the "TEXINPUTS prefix" the WD is the directory from which you start LyX, and thus could change for each LyX session. For the "TEXINPUTS prefix" path the WD is the directory containing the document. The path "." (without quotes) is a common example of a relative path and refers to the WD.</string>
</property> </property>
<property name="sizeType" > <property name="wordWrap">
<enum>QSizePolicy::Expanding</enum> <bool>true</bool>
</property> </property>
<property name="sizeHint" stdset="0" > </widget>
<size>
<width>329</width>
<height>16</height>
</size>
</property>
</spacer>
</item> </item>
<item row="10" column="0" > <item row="10" column="0" >
<widget class="QLabel" name="pathPrefixLA" > <widget class="QLabel" name="pathPrefixLA" >
@ -65,7 +59,7 @@
<item row="11" column="1" colspan="2"> <item row="11" column="1" colspan="2">
<widget class="QLineEdit" name="texinputsPrefixED"> <widget class="QLineEdit" name="texinputsPrefixED">
<property name="toolTip"> <property name="toolTip">
<string>Specify those directories which should be prepended to the TEXINPUTS environment variable. A '.' represents the current document directory. Use the OS native format.</string> <string>Specify those directories which should be prepended to the TEXINPUTS environment variable. Use the OS native format.</string>
</property> </property>
</widget> </widget>
</item> </item>