datalad-handbook/docs/basics/topic/adjustedmode-unlockedfiles.rst
Michael Hanke 05d1af4a10 Move windows-wit box content into dedicated file
The main goal is to trim the diff to the print version again, where
content was moved and taken out of containers. This makes merged
conflict-ladden and painful. With this approach, any content change
would happen in the dedicated file, which can be used for boxes
and sections alike. Associated index items must stay outside,
because they are declared on the container.

This changeset is complete, the rest will happen in the print-version
branch.
2023-11-06 16:42:30 +01:00

12 lines
1.1 KiB
ReStructuredText

The section below describes something that is very confusing for people that have just started with DataLad: Some files in a dataset can't be modified, and if one tries, it results in a "permission denied" error.
Why is that?
The remainder of this section and the upcoming chapter :ref:`chapter_gitannex` contain a procedural explanation.
However: This doesn't happen on Windows.
The "unlocking" that is necessary on almost all other systems to modify a file is already done on Windows.
Thus, all files in your dataset will be readily modifiable, sparing you the need to adjust to the unexpected behavior that is described below.
While it is easier, it isn't a "more useful" behavior, though.
A different Windows Wit in the next chapter will highlight how it rather is a suboptimal workaround.
Please don't skip the next section -- it is useful to know how datasets behave on other systems.
Just be mindful that you will not encounter the errors that the handbook displays next.
And while this all sounds quite cryptic and vague, an upcoming Windows Wit will provide more information.