Comes from PR 251109
How to mount NTFS disks is a FAQ in our chats and forums.
Add a section in handbook/disks under 18. Storage with straightforward
information on how to mount NTFS disks.
Details
Details
- Reviewers
0mp - Group Reviewers
docs - Commits
- R9:5d0182eabb00: [handbook]: Document how to mount NTFS disks
- igor clean
- aspell happy
- Handbook renders nicely
Diff Detail
Diff Detail
- Repository
- R9 FreeBSD doc repository
- Lint
Lint Not Applicable - Unit
Tests Not Applicable
Event Timeline
Comment Actions
Here's a few nits I noticed.
Otherwise, it looks good to me.
| en_US.ISO8859-1/books/handbook/disks/chapter.xml | ||
|---|---|---|
| 1575 ↗ | (On Diff #82201) | |
| 1585 ↗ | (On Diff #82201) | |
| 1590–1593 ↗ | (On Diff #82201) | Would it be better to recommend using kld_list in rc.conf? |
| 1611 ↗ | (On Diff #82201) | It's a bad idea to mount things in the user home directory, and /mnt already exists in hier(7). |
| 1627 ↗ | (On Diff #82201) | If you change the mount-point above, remember to fix this one too. ;) |
| en_US.ISO8859-1/books/handbook/disks/chapter.xml | ||
|---|---|---|
| 1585 ↗ | (On Diff #82201) | Isn't "fuse" an acronym? In that case, shouldn't it be "FUSE" with appropriate markup? (Cf. 9.6.2 in https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/docbook-markup-inline-elements.html.) |
| 1585 ↗ | (On Diff #82201) | I'd go one step further and just make it "Before using". |
| 1635 ↗ | (On Diff #82201) | And this one too. |
| en_US.ISO8859-1/books/handbook/disks/chapter.xml | ||
|---|---|---|
| 1585 ↗ | (On Diff #82201) | Thanks, it reads betteer |
| 1585 ↗ | (On Diff #82201) | Yes. Distinguish between FUSE and fusefs(5) |
| 1590–1593 ↗ | (On Diff #82201) | Thanks a lot! I wasn't aware of that problems rc.conf(5) even says it is usually faster load modules with kld_list than in the loader. |
Comment Actions
- Shouldn't Microsoft be stylized as µsoft;?
- We may consider adding a line suitable for fstab(5). I think that many people think that FUSE-based filesystems do not work well with fstab, which is not true. That could also be another commit.
- Great work!
| en_US.ISO8859-1/books/handbook/disks/chapter.xml | ||
|---|---|---|
| 1598 ↗ | (On Diff #82210) | Hmmm, I wonder if we should remove the ports installation instructions and just link to the ports chapter in the handbook. I'd advocate for this approach to reduce the duplication of documentation. Also, an inexperienced user may accidentally use ports instead of packages here which may cause some unnecessary complications. What do you think? |
| 1611 ↗ | (On Diff #82201) | I'm not opposed to the change, I'm just curious: why is mounting in /home a bad idea? |
Comment Actions
Address feedback by 0mp
- Use µsoft;
- Add line for fstab(5)
- Add references to pkg and ports sections and keep the pkg example.
| en_US.ISO8859-1/books/handbook/disks/chapter.xml | ||
|---|---|---|
| 1598 ↗ | (On Diff #82210) | I think referencing the pkg and ports section is pretty useful. I would keep the pkg example since it is pretty straightforward (it does not involve any curses screen asking to set options or anything). As a user I would not like to jump to a different section just to install a single package :-) |
Comment Actions
Looks great!
I don't know much about the new style guide for the doc tree, I have to catch up a bit.
| documentation/content/en/books/handbook/disks/_index.adoc | ||
|---|---|---|
| 1062 | Just to make sure, is it supposed to be not aligned like that? | |
| documentation/content/en/books/handbook/disks/_index.adoc | ||
|---|---|---|
| 1062 | This is what I see in git log -c when executed in my feature branch: +[source,bash] +.... +# gpart show da0 +=> 63 1953525105 da0 MBR (932G) + 63 1953525105 1 ntfs (932G) +.... + However, as I type this in the text box in phabricator, the copy-pasted text looks unaligned. | |