Apache OpenOffice (AOO) Bugzilla – Issue 128380
FAQ install instructions for Mac are confusing
Last modified: 2020-05-27 20:29:39 UTC
On the Forum page https://forum.openoffice.org/en/forum/viewtopic.php?f=74&t=89283, in A03, the instructions are not as clear as they could be. I suggest the following changes: 1. "After verifying the file, the Mac will display a screen which ..." "After verifying the file, the Mac will display a WINDOW THAT ..." (uppercase used here only to highlight the change) 2. "Drag the OpenOffice.app icon on that screen into the Applications folder icon on that screen." "Drag the OpenOffice.app icon IN that WINDOW ONTO the Applications folder icon IN that WINDOW." (uppercase used here only to highlight the change) It would also be useful to tell people how to unmount the "OpenOffice" virtual disk (e.g., drag it to the Trash).
I see now that my last comment is not appropriate, since there is a statement to "Use File → Eject 'OpenOffice' (the dmg file)." However, that is not ejecting "the dmg file"--it is ejecting the virtual disk contained in (and mounted by) the dmg file. Also, there is no mention of the need to click on the "OpenOffice" *desktop* *icon* before initiating the eject, which is very different than the actual dmg file. I would change "Use File → Eject 'OpenOffice' (the dmg file)." to the following: "Click on the desktop 'OpenOffice' icon, and then use File → Eject 'OpenOffice' to eject that virtual disk." (with double quotes used in the actual text). Or you could simply state "Drag the desktop 'OpenOffice' icon to the Trash to eject that virtual disk." (although people might be hesitant to put anything in the Trash).
(In reply to Chuck Spalding from comment #1) > I see now that my last comment is not appropriate, since there is a > statement to "Use File → Eject 'OpenOffice' (the dmg file)." > > However, that is not ejecting "the dmg file"--it is ejecting the virtual > disk contained in (and mounted by) the dmg file. No. That is ejecting(unmounting) the .dmg file > Also, there is no mention of the need to click on the "OpenOffice" *desktop* > *icon* before initiating the eject, which is very different than the actual > dmg file. Most Macs download files to the download folder although one can change it to the desktop, or any other location. > > I would change "Use File → Eject 'OpenOffice' (the dmg file)." to the > following: > > "Click on the desktop 'OpenOffice' icon, and then use File → Eject > 'OpenOffice' to eject that virtual disk." (with double quotes used in the > actual text). The default on Macs put the .dmg in the download folder. There is no icon on the desktop. There are a couple of ways to eject it in Finder. > Or you could simply state "Drag the desktop 'OpenOffice' icon to the Trash > to eject that virtual disk." (although people might be hesitant to put > anything in the Trash). Dragging the .dmg to Trash DOES NOT eject it.
(In reply to Larry Gusaas from comment #2) > (In reply to Chuck Spalding from comment #1) > > I see now that my last comment is not appropriate, since there is a > > statement to "Use File → Eject 'OpenOffice' (the dmg file)." > > > > However, that is not ejecting "the dmg file"--it is ejecting the virtual > > disk contained in (and mounted by) the dmg file. > > No. That is ejecting(unmounting) the .dmg file The dmg file is simply a file in the download folder (or wherever). It never gets "ejected". The thing that is ejected is the virtual disk (i.e., the icon on the desktop [see below]). > > Also, there is no mention of the need to click on the "OpenOffice" *desktop* > > *icon* before initiating the eject, which is very different than the actual > > dmg file. > > Most Macs download files to the download folder although one can change it > to the desktop, or any other location. Agreed, although technically it's the browser that decides where to put downloaded files, not "the Mac" (i.e., not macOS). > > I would change "Use File → Eject 'OpenOffice' (the dmg file)." to the > > following: > > > > "Click on the desktop 'OpenOffice' icon, and then use File → Eject > > 'OpenOffice' to eject that virtual disk." (with double quotes used in the > > actual text). > > The default on Macs put the .dmg in the download folder. There is no icon on > the desktop. There are a couple of ways to eject it in Finder. There *is* an icon on the desktop after one *opens* the .dmg file. The icon is named "OpenOffice", and represents the virtual disk that contains the OpenOffice program, the license files, and the ReadMe files. Again, one does *not* "eject" the .dmg file! It is just a file. One ejects the *virtual disk*. > > Or you could simply state "Drag the desktop 'OpenOffice' icon to the Trash > > to eject that virtual disk." (although people might be hesitant to put > > anything in the Trash). > > Dragging the .dmg to Trash DOES NOT eject it. Agreed, because one never "ejects" the .dmg file. Dragging the .dmg file to the Trash simply deletes that file (which can be done anytime after the file has been opened--even while the virtual disk is still mounted).
(In reply to Chuck Spalding from comment #3) > (In reply to Larry Gusaas from comment #2) > > (In reply to Chuck Spalding from comment #1) > > > I see now that my last comment is not appropriate, since there is a > > > statement to "Use File → Eject 'OpenOffice' (the dmg file)." > > > > > > However, that is not ejecting "the dmg file"--it is ejecting the virtual > > > disk contained in (and mounted by) the dmg file. > > > > No. That is ejecting(unmounting) the .dmg file > > The dmg file is simply a file in the download folder (or wherever). It never > gets "ejected". The thing that is ejected is the virtual disk (i.e., the > icon on the desktop [see below]). If the .dmg icon is on the desktop using File/Eject ejects it. > > The default on Macs put the .dmg in the download folder. There is no icon on > > the desktop. There are a couple of ways to eject it in Finder. > > There *is* an icon on the desktop after one *opens* the .dmg file. The icon > is named "OpenOffice", and represents the virtual disk that contains the > OpenOffice program, the license files, and the ReadMe files. No. That is a window, not an icon. If that is what is on the desktop going to File does not have an option to eject it. You can close the window, like any other window > > Again, one does *not* "eject" the .dmg file! It is just a file. One ejects > the *virtual disk*. True. Since you are referring is a window on the desktop of of an open .dmg. If it is the icon for a .dmg, which is not usually on the desktop, you can eject it if it is open.
(In reply to Larry Gusaas from comment #4) Have you tried to do the steps described? Please see below for my (repeated) attempt to clarify the operations and terminology. > (In reply to Chuck Spalding from comment #3) > > (In reply to Larry Gusaas from comment #2) > > > (In reply to Chuck Spalding from comment #1) > > > > I see now that my last comment is not appropriate, since there is a > > > > statement to "Use File → Eject 'OpenOffice' (the dmg file)." > > > > > > > > However, that is not ejecting "the dmg file"--it is ejecting the virtual > > > > disk contained in (and mounted by) the dmg file. > > > > > > No. That is ejecting(unmounting) the .dmg file > > > > The dmg file is simply a file in the download folder (or wherever). It never > > gets "ejected". The thing that is ejected is the virtual disk (i.e., the > > icon on the desktop [see below]). > > If the .dmg icon is on the desktop using File/Eject ejects it. The ".dmg icon" (wherever it is) represents the *file* that was downloaded. It is simply a file. It *never* gets "ejected". It (eventually) gets *deleted*. > > > The default on Macs put the .dmg in the download folder. There is no icon on > > > the desktop. There are a couple of ways to eject it in Finder. > > > > There *is* an icon on the desktop after one *opens* the .dmg file. The icon > > is named "OpenOffice", and represents the virtual disk that contains the > > OpenOffice program, the license files, and the ReadMe files. > > No. That is a window, not an icon. If that is what is on the desktop going > to File does not have an option to eject it. You can close the window, like > any other window Yes, there is a *window* named "OpenOffice" that displays the contents of the virtual disk. That virtual disk is represented by the "OpenOffice" *icon* on the desktop after the .dmg file is opened. > > Again, one does *not* "eject" the .dmg file! It is just a file. One ejects > > the *virtual disk*. > > True. Since you are referring is a window on the desktop of of an open .dmg. > If it is the icon for a .dmg, which is not usually on the desktop, you can > eject it if it is open. It's incorrect to refer to "the desktop of an open .dmg file". There is only one desktop on the Mac--the machine's desktop. On that desktop there can be icons for the mounted "disks" (i.e., "Macintosh HD" [which might be hidden], any mounted USB storage devices, and the "OpenOffice" virtual disk we're discussing). Perhaps your "open .dmg file" is the virtual disk that I am referring to. That is, when the .dmg file is opened, it's contents are used to *create* a virtual disk that is represented by the "OpenOffice" icon on the Mac desktop. However, after that is done, the .dmg file is *totally* out of the picture--it is no longer "open"--it is simply the file from which the virtual disk was loaded. The "OpenOffice" window that I am referring to is a regular Finder window that is displayed like any Finder window. (Perhaps you could say that window is displayed "on the desktop".) That window shows the contents of the virtual disk named "OpenOffice". Perhaps this example will help: Plug in a USB thumb drive. An icon appears on the desktop with the thumb drive's assigned name. Double click on that icon and a window opens with the same name showing the contents of the thumb drive. To eject the thumb drive, you operate on its desktop icon. For the discussion at hand, double-clicking on the .dmg file is equivalent to inserting the thumb drive--the "OpenOffice" icon appears on the desktop, representing the virtual disk loaded *from* the .dmg file (that icon is no longer associated with the source .dmg file in any way). In this case, the "OpenOffice" window is automatically opened, showing the contents of the virtual disk. After OpenOffice is installed (i.e., copied to the Applications folder), the virtual disk is ejected by operating on its "OpenOffice" desktop icon. Again, that is totally unrelated to the .dmg file. Before you respond again, please perform the operations yourself.
(In reply to Chuck Spalding from comment #0) > On the Forum page > https://forum.openoffice.org/en/forum/viewtopic.php?f=74&t=89283, in A03, > the instructions are not as clear as they could be. Well, Bugzilla is not the right tool to ask these changes. You should post directly on the Forum.