Some things forgotten to be fixed

[GoogleCodeExporter]

Hello, Limodou. I have the last fix proposals for the main menu 'File'.
Please fix everything as proposed here. Okay, here it goes...

----------------------------

- Please fix the 'New File' toolbar button pop-up description to 'New Document'

- Please fix the 'Open File' toolbar button pop-up description to 'Open
Document'

- Please fix the 'Save File' toolbar button pop-up description to 'Save
Document'

- Please fix the 'Save All Files' toolbar button pop-up description to
'Save All Documents'

- File > Reopen: 'Reopens current document again.' --> 'Opens the current
document again.'

Please note that the word 'reopen' is actually 'open again', so saying
'reopen again' is incorrect in English grammar; correct is either 'open
again' or 'reopen'. I think that the help string 'Opens the current
document again.' is better than 'Reopens the current document.', because
the former is more explicit I think. You really need to fix this because it
is a help string typo. (Please consider of removing this feature because it
doesn't work anyway.)

- File > Save > save file dialog title 'Save Document xxxx As...': Please
make this title display just the filename (in the place marked with xxxx)
and not the whole path to the file. So if a document 'simplecalc.py' is
opened and you want to save it as another filename by clicking the 'Save
As...' menu item, then the title of the save file dialog should be 'Save
Document simplecalc.py As...' and *not* as 'Save Document C:\Documents and
Settings\Chester\My Documents\Projects\Simple Calculator\simplecalc.py
As...' because in such a case the title is soooo long that it doesn't fit
on the frame's titlebar of the dialog. If it is doable, please make the
filename of the document be displayed in the titlebar of the dialog and not
the whole path of the document. That would be much better.

- File > please fix menu item label 'Recent Files...' --> 'Recent Documents...'

When you open a *document*, it is added to the recent *documents* list.
That's logical. If opening a *document* would be added to the recent
*files* list, that wouldn't be logical at all. So in order to be logical
and consistent, you really should change this menu item label to 'Recent
Documents...'

- File > 'Recent Documents...': 'Opens recent files pop-up window.' -->
'Opens the recent documents pop-up window.'

Please add the word 'the' and change the word 'files' to 'documents'.

- File > Save Session... > dialog 'Save Session': dialog title 'Save
Session' --> 'Save Session File As...'

This fix is important. As I have tested, the behaviour of the 'Save
Session...' resembles the behaviour of 'Save As...', so to make things
consistent you need to change the title of the 'Save Session' dialog to
'Save Session File As...'

- File > Print > please fix the menu item label 'Print' --> 'Print Document'

It is kind of ackward to have a 'Print' menu item under a 'Print' submenu,
because you have two same names. This should be avoided, really. Since you
have 'Print HTML Document', it would be consistent and good to have the
manu item 'Print' named as 'Print Document'. Please do this.

- File > Print > Page Setup...: 'Sets the page layout and options.' -->
'Changes the page layout settings.'

This help string was adopted from Microsoft WordPad and I think it should
be used in UliPad as well, because it very clearly states what the action
of clicking on the menu item 'Page Setup...' would do.

- File > Print > Print Preview... > dialog 'Print Preview'

If you have a non-saved document opened (for example 'Untitled 1.py') and
you click on the menu item 'Print Preview...' to open the dialog 'Print
Preview', then the title of this dialog is displayed as 'Print Preview -'.
This looks ugly. Please make the title of this dialog be displayed as
'Print Preview' (without that minus sign -).

Another thing to fix in this dialog is the button label of the button 'Goto
page...'. Please fix it like this:
'Goto page...' --> 'Go to page...'

The space between between the words 'Go' and 'to' is needed. Please fix this.

And if you click on the button 'Go to page...', a dialog opens. This dialog
has a typo as well. Please fix the dialog's title like this:
'Goto Page' --> 'Go To A Page'

--------------------

I have worked really hard to give you the best proposals. Please fix all of
this as proposed, because I have spent almost 3 hours thinking and typing
this proposal list. And I think that UliPad will be even better after
you'll fix all of these things. And this is what my intention is, to make
UliPad better. After you'll fix this, I will type the help string proposal
list for the main menu 'Edit'.

Regards,
Chester Dunn

Original issue reported on code.google.com by wxPytho...@gmail.com on 16 Jul 2008 at 7:38

[GoogleCodeExporter]

Chester, why are you so hung up on calling files 'documents'? limodou isn't 
going to 
change 'File' on the menu bar to 'Document', so why change 'File' to 'Document' 
elsewhere? Please spell out what you consider the distinction between files and 
documents, and tell us why the change is so important, even though other IDEs 
continue to use 'File' on their menus as well as on their menu bars. This 
includes 
another IDE I just examined, PythonWin. 

Thanks,

Dick

Original comment by rdmoo...@gmail.com on 16 Jul 2008 at 8:24

[GoogleCodeExporter]

Well, the thing is that everything must be consistent. Since we already have 
the main
menu 'Document', the main menu 'File' cannot be renamed. And I don't want to 
rename
it anymore. I think that it is difficult to understand what a file is and what a
document is. Because a file is a source for a document so it is hard to tell 
which
word to use in UliPad. When talking about the file dialog for example, you open 
a
file with it; and when that file is opened, you are dealing with a document. So 
it's
kind of complicated. Maybe the help string of the menu item 'Open...' should be
'Opens an existing file.' afterall, and the 'Choose A Document' dialog title 
should
be 'Choose A File'. When you have a file opened, you actually have a document 
opened;
and when you save it, you save a *document* and *not a file*; but you save that
document *into* a file. More techically speaking, you save a document into a 
file object.

Limodou, so please fix this:

- File > Open...: 'Opens an existing document.' --> 'Opens an existing file.'

Please fix the title of the open file dialog from 'Choose A Document' to 
'Choose A
File' as well.

- File > Save As...: 'Saves the current document to a new file.'
Please note that the title of the save file dialog is okay, but it really 
doesn't
need the whole path of the file displayed. Please either remove the file path 
to be
displayed or make only the filename to be displayed in the title of this dialog.

Oh, and the title of the open session dialog entitled 'Choose A Session File' is
okay. Don't change it please.

Limodou, please fix everything else as it was proposed in this issue report.

I think this is how it should be from the start. Now everything will be correct 
if
you fix it like so. Please fix it as proposed above and here.

Regards,
Chester Dunn

Original comment by wxPytho...@gmail.com on 16 Jul 2008 at 9:36

[GoogleCodeExporter]

For me, I don't think document and file are so much different. But I think 
document
is mainly used for opened file, and file is mainly disk file. But many softwares
don't care about them so much I think. Maybe we should to see how do they use, 
then
we can change them.

Original comment by limo...@gmail.com on 17 Jul 2008 at 1:04

[GoogleCodeExporter]

And I found in EditPlus help document, you can see these:

New Creates a new document.
New Normal Text Creates a new normal document.
New HTML    Creates a new HTML document.
New Browser Creates a new Browser window.
Configure Templates Adds or removes document templates.
Document Template   Creates a new document using document template.
Open    Opens an existing document.
Close   Closes an opened document.
Close All   Closes all document windows.
Lock Files  Protects open files from modified by other applications.
Save    Saves an opened document using the same filename.
Save All    Saves all documents.
Save As Saves an opened document to a specified file name.
Print   Prints a document.
Print Direct    Prints the active document directly.
Print Preview   Displays the document on the screen as it would appear printed.
Print Setup Selects a printer and printer connection.
Print All   Prints all open documents.
FTP Upload  Uploads file to FTP server.
Upload Multiple Uploads multiple files to FTP server.
Upload All  Uploads all open files to FTP server.
Open Remote Opens an existing document from FTP server.
Save As Remote  Saves the active document as a remote FTP file.
FTP Settings    Sets the FTP account information.
Disconnect  Closes all FTP connections.
Send    Sends the document through electronic mail.
Open Header File    Opens the header file of the C/C++ file.
Delete  Deletes the active document file.
Recent Files    Opens last documents you closed.
Properties  Displays the file's properties.
Save & Exit Saves all documents and quits the application.
Exit    Exits EditPlus.

So you can see, even EditPlus(I should say I used it everyday before I developed
UliPad and now), it uses File in menu item, but use document in help string. 
And I
also found that "Save all documents" has no "the" before documents. So I think 
we
don't need to care about the spell so much, and after see this, I even don't 
know
which one should be right. If I need to change ulipad's menu like this?

Original comment by limo...@gmail.com on 17 Jul 2008 at 1:15

[GoogleCodeExporter]

And here is UltraEdit(popular editor) manual:

New opens an existing document
Open opens an existing document allowing entry of name without browse dialog
Quick Open closes an opened document
Close closes all opened documents
Close All Files closes all opened documents except the active one
Close All Files Except This
FTP/Telnet - FTP/SFTP Browser
presents FTP/SFTP Browser
opens an existing document from an FTP site
FTP/Telnet - Open from FTP saves an opened document to a specified file name on 
an
FTP site
FTP/Telnet - Save As to FTP
FTP/Telnet - FTP Account Manager shows or hides the FTP/SFTP Account Manager
FTP/Telnet - SSH/Telnet Console shows or hides the SSH/Telnet console
FTP/Telnet - SSH/Telnet Account Manager shows or hides the SSH/Telnet Account 
Manager
reverts to saved file Revert to Saved saves an opened document using the same 
file name
Save saves an opened document to a specified file name
Save As saves all modified documents using their current file names
Save All saves selection to a new file

So you can see sometimes it uses file, and sometimes it uses document.

Original comment by limo...@gmail.com on 17 Jul 2008 at 1:40

[GoogleCodeExporter]

I have searched the difference between a 'file' and a 'document'. I have 
discovered
that there is a difference between those two things. Nobody cares about this
difference so they commonly switch between those two words being used. But that 
is
wrong. Even though some well-known applications don't care about this 
difference,
that doesn't mean that there's no difference. I have extensively Googled and 
read a
lot about disk storage and file systems and everything that relates to the 
topic we
are discussing about.

And this is what I have discovered. A file is a collection of bits that has a 
name
(by which it can be found on the disk platter by the hard disk head) and it 
also has
an extension; like 'myfile.txt' is a file that (if it contains any bits) is a
collection of bits that can be found by the name 'myfile' and opened with an
application that handles the TXT file format. The hard disk head reads the 
magnetic
data from the disk platter, and a file is just magnetic data on this disk 
platter
that was transformed into bits; but in order for you to get that particular 
magnetic
data (so that you'll be able to access it), you store it in a file which makes 
it
possible for the hard disk head to find that magnetic data on the disk platter 
and
make it possible for you to read that or do whatever you want to do with it.

Okay so that was a file. Now I will tell you what a document is. What a 
document is,
is a bounded physical representation of body of information designed with the
capacity and usually intent to communicate. So a document is basically a 
physical
object, but with the existence of computers a document became a digital object 
as well.

The thing is that we have a document as a file. So people think that a document 
and a
file are the same thing but they are not. Every document corresponds to a file. 
So
when you read a file in a text editor, you have a document in front of you on 
the
computer screen; but when you delete a document, you are actually dealing with 
the
file in this case. So my point is this... When you open the file dialog in 
UliPad by
clicking the menu item 'Open...' in the main menu 'File', you are dealing with 
files,
so the title of the file dialog should be 'Choose A File'. You are actually 
choosing
a named collection of bits (a file) from the hard disk and then have them (the 
bits)
presented to you as a document (displaying it with UliPad).

And the 'Save As...' dialog also deals with files, so this dialog's title 
should also
have the word 'file' and not the word 'document' in it.

And the label of the menu item 'Recent Files...' is not correct, it should be 
'Recent
Documents...' because by clicking this menu item opens up a list of files and
clicking on an item in this list opens a document.

--------------

I don't wanna make a separate issue report, so I'll post two bug reports here...

(1) If I click on the menu item 'Reopen', the document I am viewing isn't 
reopened;
actually nothing happens when you click on this menu item.

(2) Edit > Preferences... > page General > Default color theme: I must tell you 
that
if you change the color theme to, say, 'White' and you click Apply, the color 
theme
is not changed; even if I exit Ulipad and open it again, it is the same thing.

Regards,
Chester Dunn

Original comment by wxPytho...@gmail.com on 19 Jul 2008 at 5:00

[GoogleCodeExporter]

And I would like to keep up with other popular editor usage, but not to create 
a new
format. So I'll check other editor usage and keep up with them.

For reopen, it's just reopen the file. It'll just overwrite current context 
with disk
file context. So if you made no changes, you should see nothing different.

For color theme, it only effect when there is not such syntax file exists, so 
you
should check if there are some *.stx files in conf/stx, if there are, color 
theme
will no affect for these language at all. You can remove them, and try again.

Original comment by limo...@gmail.com on 20 Jul 2008 at 2:38

[GoogleCodeExporter]

Limodou, please fix the strings as they were proposed by me. I have really
investigated this and I think I got it right. I would very much appreciate if 
you do
this. Thank you.

Original comment by wxPytho...@gmail.com on 20 Jul 2008 at 11:35

[GoogleCodeExporter]

Just as I said I would like to keep up with other editor usage.

Original comment by limo...@gmail.com on 20 Jul 2008 at 2:36

[GoogleCodeExporter]

Okay. But please be very consistent and very accurate. This is very important. 
I am a
guy that has to have everything in order and I am annoyed by every tiny 
imperfection.
Please do this right. I hope you'll fix this soon. Thank you.

Original comment by wxPytho...@gmail.com on 20 Jul 2008 at 8:15

[GoogleCodeExporter]

Original comment by limo...@gmail.com on 23 Jul 2008 at 1:16

• Changed state: Fixed