Hi all!
While working on the translation of the (main) manpage, I noticed a few issues in the English version and started working on a patch. That was quite some time ago, I had little spare time lately and didn't get around to finish and send it in. So I figured I just take what I have now and ask you guys for comments. I appreciate any remarks or suggestions.
Thanks, Julian
Notes:
I had a change similar to Frédéric's, mentioning wine can run 64-bit programs now. He was quicker and I like his wording better. I had something like "[...]or Win64 executable (if your version of wine was compiled with 64-bit support)." I guess that would be more confusing to people using their distro's wine packages and people compiling their own wine know that anyway. Do you agree or do you think it's better to be more specific?
CUI -> CLI: According to Google and Wikipedia, CLI is more common.
-.BR @bindir@/wineserver , +.IR @bindir@/wineserver , and following, similar changes:
This is the way it is formatted in the wineserver manpage. I noticed there is no uniform style across our manpages, so we should have a guideline. Should paths be bold or italic/underlined?
Am 16.07.2013 19:59, schrieb Julian Rüger:
Hi all!
While working on the translation of the (main) manpage, I noticed a few issues in the English version and started working on a patch. That was quite some time ago, I had little spare time lately and didn't get around to finish and send it in. So I figured I just take what I have now and ask you guys for comments. I appreciate any remarks or suggestions.
Thanks, Julian
Notes:
I had a change similar to Frédéric's, mentioning wine can run 64-bit programs now. He was quicker and I like his wording better. I had something like "[...]or Win64 executable (if your version of wine was compiled with 64-bit support)." I guess that would be more confusing to people using their distro's wine packages and people compiling their own wine know that anyway. Do you agree or do you think it's better to be more specific?
Frédéric has done it quite good, because it's committed :) Further you can't compile Wine in 64-bit mode on 32-bit that easily, and you can't run it, your version doesn't handle that.
CUI -> CLI: According to Google and Wikipedia, CLI is more common.
i'd say that's analogue to IMAGE_SUBSYSTEM_WINDOWS_CUI
-.BR @bindir@/wineserver , +.IR @bindir@/wineserver , and following, similar changes:
This is the way it is formatted in the wineserver manpage. I noticed there is no uniform style across our manpages, so we should have a guideline. Should paths be bold or italic/underlined?
Not sure, are there other guidelines out there we can use?
Frédéric has done it quite good, because it's committed :) Further you can't compile Wine in 64-bit mode on 32-bit that easily, and you can't run it, your version doesn't handle that.
Naturally. But yeah, I guess not everyone knows that, good point.
CUI -> CLI: According to Google and Wikipedia, CLI is more common.
i'd say that's analogue to IMAGE_SUBSYSTEM_WINDOWS_CUI
So, do you think I should leave it? To the average reader, CLI should be clearer. I thought it was a typo at first. ;)
Should paths be bold or italic/underlined?
Not sure, are there other guidelines out there we can use?
Anyone else?
Best, Julian
Am 17.07.2013 22:19, schrieb Julian Rüger:
Frédéric has done it quite good, because it's committed :) Further you can't compile Wine in 64-bit mode on 32-bit that easily, and you can't run it, your version doesn't handle that.
Naturally. But yeah, I guess not everyone knows that, good point.
CUI -> CLI: According to Google and Wikipedia, CLI is more common.
i'd say that's analogue to IMAGE_SUBSYSTEM_WINDOWS_CUI
So, do you think I should leave it? To the average reader, CLI should be clearer. I thought it was a typo at first. ;)
I'd leave it. Anyone else?
Should paths be bold or italic/underlined?
Not sure, are there other guidelines out there we can use?
Anyone else?
Did Frédérics recent patches handle that?
i'd say that's analogue to IMAGE_SUBSYSTEM_WINDOWS_CUI
So, do you think I should leave it? To the average reader, CLI should be clearer. I thought it was a typo at first. ;)
I'd leave it. Anyone else?
Ironically, in the existing German translation it says CLI.
Should paths be bold or italic/underlined?
Not sure, are there other guidelines out there we can use?
Anyone else?
Did Frédérics recent patches handle that?
I can't really tell, although there are a few occurrences that look similar, like
-outputs the data either in a standard \fB.bin\fR formatted binary +outputs the data either in a standard \fI.bin\fR formatted binary
If nobody else speaks up, I'll give it a shot, maybe leave out the CUI/CLI part for now.
Thanks, André!
-
André Hentschel -
Julian Rüger