Beginning on October 25th, 2016, Persona will no longer be an option for authentication on BMO. For more details see Persona Deprecated.
Last Comment Bug 63317 - Maintain docs for "Internet Keywords"
: Maintain docs for "Internet Keywords"
Classification: Other
Component: General (show other bugs)
: other
: All All
: -- trivial
: ---
Assigned To: benc
Depends on:
  Show dependency treegraph
Reported: 2000-12-19 11:46 PST by Tobias Burnus
Modified: 2012-08-23 00:16 PDT (History)
5 users (show)
See Also:
QA Whiteboard:
Iteration: ---
Points: ---

Suggestions about grammar, usage, and the use of the H2 tag (9.41 KB, patch)
2004-08-23 00:57 PDT, Jonathan Nieder
no flags Details | Diff | Splinter Review

Description Tobias Burnus 2000-12-19 11:46:47 PST
Hi, clicking on "more information" in the preferences of internet keywords
should open a window (loaded from the harddisk not from the net, as it is done
for cookies and internetsecurity) which explains how to use them (go keyword
syntax as I learned from bug 58141).
Presently is opened which isn't really a help.
(I dislike (a) that there is no explanation and (b) that it accesses the net.)
Comment 1 Boris Zbarsky [:bz] (still a bit busy) 2000-12-19 11:53:10 PST
The current "explanation" is definitely unenlightening.  status -> new
Comment 2 Christian :Biesinger (don't email me, ping me on IRC) 2001-02-04 14:24:30 PST
Clicking on "More Information" makes it pretty hard to find the preferences
window after reading the page - the browser window hides the preferences window.
Futhermore, after closing the window you can see the preferences window with a
window in the back - the one you just closed???

And when choosing Edit/Preferences in the "explanation window" again, the
preferences don't appear, and you can't do anything w/ Mozilla, at least not
with the current window.
Comment 3 Keyser Sose 2001-02-27 15:48:12 PST
Triaging the Most doomed (which Happens to Ben right now :)

Adding polish keyword.
Comment 4 Blake Ross 2001-04-13 21:12:04 PDT
-> UI Design for wording/best help
Comment 5 Matthew Paul Thomas 2001-04-16 05:17:21 PDT
Internet Keywords are Netscape, not Mozilla, right? (And if not, why not?) So 
what does it have to do with me?

See also bug 52372, which (IMO) hasn't been properly fixed yet.
Comment 6 Claudius Gayle 2001-04-17 11:04:17 PDT
not exactly. Keywords are built-in to the browser. Netscape makes more open use of them by
including a keyword dropdown next to the url bar  - but that doesn't mean they don't still work
just fine. In the NS build, clicking 'more info' opens up a new browser window connected to a page
that amazingly enough, contains more information.

So, if the summary of this bug is the true goal - then your more info is available. You could
point to the page(I guess) or host a similar version, or do this like all the other prefs and simply
load a static page that is shipped with the browser.
Comment 7 Matthew Paul Thomas 2001-04-18 04:02:26 PDT
Well, I don't see why:
*   opening a browser window, in which the menus appear enabled but cannot be
    clicked, can possibly be acceptable (no matter what page the browser
*   a feature should exist in a non-commercial build of Mozilla which exists
    solely to take you to pages on (blocks bug 14532);
*   a feature should exist in Mozilla at all where typing `quote Shakespeare'
    in the address field will result in something different from a Web search
    for Shakespeare quotes.

So I think Internet Keywords should go away. But while they're in Mozilla, the 
proper place to provide help for them is in the online help, not in a browser 
window. --> Help
Comment 8 Blake Ross 2001-05-29 21:32:28 PDT
--> Ian
Comment 9 rudman 2001-11-15 16:40:55 PST
Setting to Moz 1.0.
Comment 10 benc 2001-12-16 15:03:12 PST
The mozilla default was changed to:

in another bug, where I asked to change the default to "off" and then provide
better documentation.

I'm currently re-writing the documentation for that page, because the initial
write up was not as oriented to the mozilla community as I would have liked.

So, I guess you could legitimately assign this bug to me.

I've put my latest draft in the URL field.
Comment 11 benc 2002-11-25 09:52:11 PST
-> docs. This is a web page, not in-line documentation.
Comment 12 benc 2002-12-12 11:56:17 PST
I've re-written the draft in the URL, and checked it into

Once it appears, I'm going to resolve this bug.

I am considering creating a "feedback:" bug for that document, and link the
document to the feedback bug, but nobody seems to use that on my other pages.

If you have immediate feedback, please let me know here.
Comment 13 benc 2002-12-18 09:26:52 PST
This is done.

Terri, if you are not the QA of this feature, please re-assign to the component

Also, there are problems with where the links should go in the doc structure,
see bug 186031.
Comment 14 Brant Gurganus 2003-02-01 08:11:37 PST
Comment 15 benc 2004-01-15 07:52:19 PST
Updated docs:

Removed or updated Netscape, Phoenix references. Changed examples b/c we now use
google. Explained changes to google, and how it will work.
Comment 16 benc 2004-03-01 10:42:43 PST
Need to add a "IK != search" paragraph, and a "IK server examples" section would
be nice too.
Comment 17 Jonathan Nieder 2004-08-23 00:57:44 PDT
Created attachment 156768 [details] [diff] [review]
Suggestions about grammar, usage, and the use of the H2 tag

I have attached a patch with my nitpicks about grammar, usage, and HTML.  Note
that I am not a developer, and so I do not know of any style guidelines or
things like that I should be following.  I simply wish to be more
Comment 18 Jonathan Nieder 2004-08-23 12:41:29 PDT
Sorry for the spam-like double post.

I have done a little more research, and I found two pages with
documentation already written that are as readable as I would
like.  One is the basis of the second part of the end-user docs
we already have:

However, it has a coherence that was lost with revision (probably
to avoid alienating end-users who are not developers, as well as
to add mention of the change to Google's I'm Feeling Lucky as a
keyword server).  Another of its features lost in the mists of
time is its link to the second well-written page I mentioned:

Netscape's documentation of Internet Keywords is very well made,
useful for end-users, and useful for developers.  As it is not
under the control of, to use it in the current Mozilla
doc's stead would require getting AOL to release their copyright
on it to (or FDL it, etc).  I don't know how difficult
that would be.

I suggest that
be replaced with a short page containing:
 * a paragraph explaining Internet Keywords' default behavior in Firefox
    (Internet Keywords allows you to access a page without knowing its
     address by sending unresolved requests in the location bar to
     Google's I'm Feeling Lucky service.)
 * a link to Netscape's page for novice users, and information on Netscape's
keyword server
 * a link to a local copy of's page at for
experienced users, or those wondering about internals
Comment 19 benc 2004-09-01 02:49:27 PDT
boy I'm in trouble, because, I wrote the mozilla page to replace the other two

I will look at the suggestions you made. The document was targeted to an
audience that wanted more explaination than the usual online help, but might
need some updating now that we have Moz + FF.
Comment 20 benc 2004-12-04 00:53:53 PST
I'm doing my annual doc review... does this doc need to be re-written to be
FF-centric? Or do we need a separate doc for FF?
Comment 21 benc 2004-12-04 00:54:41 PST
Should we add more comments about other keyword servers, like Bug 258838?
Comment 22 Daniel Wang 2004-12-05 12:42:48 PST
> NOTE: The change was made in "all.js", which means each installed version
> carries its own default value. Unless you changed keyword.url in your profile,
> the newer versions will use Google.

can be reduced to "The change should take effect on upgrade unless you have
customized the server setting"

The page should link to
Comment 23 Anne (:annevk) 2005-02-17 05:16:24 PST
Jonathan, could perhaps update the patch and request review from the owner of
the document or someone else capable of reviewing the document?
Comment 24 benc 2007-07-08 16:20:27 PDT
I re-wrote a lot of the context of this document to reflect the state-of-the-world, (aka Firefox 2.0). I'm mostly interested in working on fixing/improving core features, so I will not be contributing FF-only docs. Someone is welcome to make a shorter version, and I would be happy to review it and help out.

Checking in mozilla-org/html/docs/end-user/internet-keywords.html;
/www/mozilla-org/html/docs/end-user/internet-keywords.html,v  <--  internet-keywords.html
new revision: 1.14; previous revision: 1.13

- did not use, b/c it seems to be gone.
- sometime in the next year, will probably go away too (my domain).
Comment 25 benc 2007-07-08 16:31:32 PDT

I tried to follow your patch, but then CVS doctor died on me.

Your html suggestions should be followed in my change above (to the best of my ability).

I'm going to do another edit to pick up the glaring grammatical errors, but it would be nice if you reviewed the new document. Rather than a patch, I suggest making numbered suggestions in a bug comment, b/c I can check them off one-by-one.
Comment 26 benc 2007-07-08 16:45:01 PDT

Note You need to log in before you can comment on or make changes to this bug.