Skip to contentSkip to conversation

About the .txt docs files

DISCUSSION Igor 2 participants 3 messages Feb 20, 2021 – Feb 21, 2021 Documentation

lore
Share & tools
lore

Igor

author
#0 lore raw

Hi everyone,

I was converting the memory-barrier.txt to .rst so it can be properly displayed alongside the rest of the documentation that is already converted to .rst.

After I started, I realize that is better to ask if is desirable for these files to be converted in the first place.

So, that is my question, from the files in the following list there any that would be desirable for the conversion?

memory-barriers.txt
atomic_t.txt
atomic_bitops.txt
admin-guide/spkguide.txt
filesystems/dax.txt
filesystems/path-lookup.txt

Thanks in advance,
Igor M. A. Torrente

reviewer
#1 lore raw

Hi,

Yes, it's good to ask.

Quoted 9 lines · Igor

Hi everyone,

I was converting the memory-barrier.txt to .rst so it can be properly displayed alongside the rest of the documentation that is already converted to .rst.

After I started, I realize that is better to ask if is desirable for these files to be converted in the first place.

Quoted 6 lines

So, that is my question, from the files in the following list there any that would be desirable for the conversion?

memory-barriers.txt
atomic_t.txt
atomic_bitops.txt

For the atomic files, my understanding is that the owners don't want to have them converted to .rst files.
That could easily be true of memory-barriers.txt as well.

Quoted 3 lines

admin-guide/spkguide.txt
filesystems/dax.txt
filesystems/path-lookup.txt

thanks.

Signature · 1 line
~Randy
author
#2 lore raw
Quoted 17 lines · Randy Dunlap

Hi,

Yes, it's good to ask.

Quoted 12 lines · Igor

Hi everyone,

I was converting the memory-barrier.txt to .rst so it can be properly displayed alongside the rest of the documentation that is already converted to .rst.

After I started, I realize that is better to ask if is desirable for these files to be converted in the first place.

So, that is my question, from the files in the following list there any that would be desirable for the conversion?

Quoted 8 lines
Quoted 3 lines

memory-barriers.txt
atomic_t.txt
atomic_bitops.txt

For the atomic files, my understanding is that the owners don't want to have them converted to .rst files.
That could easily be true of memory-barriers.txt as well.

Ohhh, ok then.

Quoted 10 lines
Quoted 4 lines

admin-guide/spkguide.txt
filesystems/dax.txt
filesystems/path-lookup.txt

thanks.

Signature · 1 line
~Randy

Thanks Randy!