Translating some Oracle documentation

Some time ago, I sent following mail to [email protected] but did not get any answer. Is this right email address ? Could you please answer my questions ?
Hello,
The condition of OTN use say:
1. Use of Web Site Documents
You may download, view, copy and print documents, including graphics incorporated in the documents, that Oracle publishes on the Site ("Documents") such as white papers, press releases, datasheets and FAQs subject to the following: (a) the Documents may be used solely for personal, informational, non-commercial purposes; and (b) the Documents may not be modified or altered in any way. Except where your use constitutes "fair use" under copyright law, you may not otherwise use, download, upload, copy, print, display, perform, reproduce, publish, license, post, transmit or distribute any Documents or other Content from the Site in whole or in part without the express authorization of Oracle.
I would like to know under which conditions it would be allowed to translate in French some chapters (or even a whole book) of a official Oracle book available on OTN such as the Concepts Guide or the Administration Guide. When I mean translating I mean publishing it on a web site as HMTL or PDF such as developpez.com. I don't mean publishing a paper book to be sold.
Would such a translation considered as "fair use" under copyright law or not ? if not, would you give authorization ? If yes, what would be the process to follow ?
Thanks and best regards
Pierre Forstmann.
------------------------------------------------------------------------------------------------------------------------------

Thank you again for asking about posting your own online translation of our documentation into French. We cannot provide you with legal advice on what is or is not "fair use". However, we normally do not authorize independent third-party translations, because our warranties of the product are often tied to the documentation.
We cannot provide translations for everything. However, if you have information that indicates that there is significant demand for certain translations, then I would be happy to pass this information along to executive management, so that they can consider whether it is warranted for Oracle to handle such a translation in-house.
Regards,
Diana

Similar Messages

Oracle Documentation Relating to 1Z0-051

Hello,
Just wanted to some input on which Oracle Documentation Books I should be using using in order to prepare for 1Z0-051. At the moment, I am using:
Oracle Database Administrator's Guide 11g Release 2 (11.2)
Oracle Database Concepts 11g Release 2 (11.2)
Any other suggestions?
Thanks in advance,
Howard

I used "*SQL Fundamentals I Exam Guide (Exam 1Z0-051)*".
It's a complete exam preparation edited by McGraw Hill - Oracle Press.
Authors: John Watson and Roopesh Ramklass.
I thing it's a good book.

Tom Kyte -v- Oracle Documentation - Character Semantics for AL32UTF8 ?

On a unicode database, what is best practice for varchar columns - character semantics or byte semantics ?
Tom Kyte's new book Expert Oracle Database Architecture says "When using a multibyte character set such as UTF8, you would be well advised to use the CHAR modifier in the VARCHAR2/CHAR definition - that is, use VARCHAR2(80 CHAR), not VARCHAR2(80), since your intention is likely to define a column that can in fact store 80 characters of data." (p499). This I would agree with.
Yet, when I read the 10gR2 documentation "Globalization Support Guide", it says "The BYTE and CHAR qualifiers shown in the VARCHAR2 definitions should be avoided when possible because they lead to mixed-semantics databases. Instead, set NLS_LENGTH_SEMANTICS in the initialization parameter file and define column datatypes to use the default semantics based on the value of NLS_LENGTH_SEMANTICS. Byte semantics is the default for the database character set."
I'd much rather explicitly state that I'm using character semantics, than relying on some default setting. So who's right ? Tom Kyte, or the Oracle documentation ? Or are they saying different things ?
If I use character semantics, is this going to come back and bite me later ?
I'm using Oracle 10gR2, and the database character set is the default of AL32UTF8, using only VARCHAR columns - not NVARCHAR.
Thanks,
Andy Mackie

I would say that both want to say the same thing in a different way.
Whether you always specify CHAR modifier or define NLS_LENGTH_SEMANTICS to CHAR is the same ... until you decide to change NLS_LENTGH_SEMANTICS to BYTE but this change will only apply to new columns created after NLS_LENGTH_SEMANTICS parameter change and I wonder why you would to do it.
You have to use character semantics and make a choice: if you don't need to change it, it should not bite you back.

Generic Comments on Oracle Documentation

Hi,
I am not a documentation expert. But I have been working on different Oracle technologies for 7+ years. I have some general comments/suggestions on Oracle Documentation:
1) Sometimes the language is bit complicated and can be simplified to a great extent.
e.g. "The combination of all of these SOA artifacts makes up the adaptable and extensible service-oriented reference architecture that Application Integration Architecture stands for."
It could have been written in simpler language like
"The combination of all of these SOA artifacts makes up the adaptable and extensible Application Integration Architecture."
Another example is - "These are application-agnostic web services that are used by calling applications to interface with different applications. This helps the cross-application processes to be participating-application unaware.
2) At some places, the documentation is vague and doesn't really provide specifics of the underlying component/concept.
e.g. In "AIA Overview" document, there is following description for Error Resolution and Logging:
"Oracle provides a unified error-handling and logging solution that allows the identification and resolution of issues across applications, across technologies such as BPEL or Enterprise Service Bus, and across integration patterns."
But it doesn't provide specific details about the "solution".
I have seen really nice Oracle Documentation as well. But I earnestly believe there is scope to improve some of the Oracle Documentation. It will greatly help Oracle customers to better understand Oracle Products/Technologies faster.
Thank You!

Thank you for your observations and recommendations. The examples in (1) are indeed verbose and confusing; and if the document in (2) does not provide enough information about the solution, that is a shortcoming.
I did a very quick search but could not find the manuals in question. Are your examples from Oracle technical manuals or from marketing literature, such as data sheets or white papers? This is not to excuse any problems with marketing literature, but Oracle's technical documentation groups are generally not involved in writing those documents, and thus we don't control or edit their content.
In any case, I recommend that if you find problems in a technical manual, please use the "User Comments" feature (at the bottom of HTML pages for Oracle manuals accessed in documentation libraries on OTN), so that the comment can be tied to a specific manual and be directed to the appropriate writer. (Or, include the manual's title or part number in a posting in this forum.) For comments on any other Oracle materials, see if the item includes any information about sending feedback.

Posting Links to Oracle Documentation

Far too often I see a URL Link to a copy of the standard Oracle documentation hosted by some other site -- sometimes it is a University.
It would be incorrect and inappropriate to provide a link to a non-Oracle site for standard Oracle documentation.
Universities might be hosting a copy of the documentation but I would guess that this is primarily for their students although they do not prevent others from accessing the documentation.
Remember that any non-Oracle site cannot necessarily be an "authentic" source of information on Oracle documentation. Furthermore, many of these links that are posted here on forums are pointing to Oracle database 9.2 or 10.1 documentation. At the minimum ensure that you point to 10.2 or, preferrably, 11.2 documentation.
There is no issue with providing a link to a non-Oracle site when it is clear that the page provided is not intended to be read as standard Oracle documentation.
Hemant K Chitale
Edited by: Hemant K Chitale on Oct 18, 2010 2:59 PM

Thanks for pointing this out. We have updated the page to point directly to the documents: http://otn.oracle.com/software/products/oracle8i/htdocs/linuxsoft.html
OTN

Oracle Documentation is Unavailable

Hi All,
Oracle documentation page http://www.oracle.com/technetwork/indexes/documentation/index.html#em Oracle Enterprise Manager and Virtualization is unavailable, has been for some time, do not know why?
Jett

Oracle documentation page http://www.oracle.com/technetwork/indexes/documentation/index.html#em Oracle Enterprise Manager and Virtualization is unavailable, has been for some time, do not know why?
I can open and browse Oracle EM and Oracle VM docs with no issues.
Please try from a different browser/machine and check then. You may also clear the browser cache and history files.
Thanks,
Hussein

Need explanation about Oracle documentation (DBMS_LOB.LOADCLOBFROMFILE)

Hello World,
I try to understand Oracle documentation about DBMS_LOB.LOADCLOBFROMFILE function.
I am not shure the explanation is written in a very good english,
but i can't understand a word !!!
Is anybody could explain me in more simple sentences ??
DBMS_LOB.LOADCLOBFROMFILE (
dest_lob IN OUT NOCOPY BLOB,
src_bfile IN BFILE,
amount IN INTEGER,
dest_offset IN OUT INTEGER,
src_offset IN OUT INTEGER,
src_csid IN NUMBER,
lang_context IN OUT INTEGER,
warning OUT INTEGER);
Oracle documentation explanation :
src_csid Character set id of the source (BFILE) file.
lang_context (IN) Language context, such as shift status, for the current
load. (OUT) The language context at the time when the
current load stopped, and what the next load should be using if
continuing loading from the same source. This information is
returned to the user so that they can use it for the continuous
load without losing or misinterpreting any source data. For the
very first load or if do not care, simply use the default 0. The
details of this language context is hidden from the user. One
does not need to know what it is or whats in it in order to
make the call
warning (OUT) Warning message. This indicates something abnormal
happened during the loading. It may or may not be caused by the
users mistake. The loading is completed as required, and its up to the
user to check the warning message. Currently, the only possible
warning is the inconvertible character. This happens when the
character in the source cannot be properly converted to a character in
destination, and the default replacement character (e.g., ?) is used in
place. The message is defined as warn_inconvertable_char in
DBMSLOB.

I am not kidding. I posted the link but I did not check if it were the same source. Really I do not have time to realize it.
I think you can get a fast answer in SQL & PL/SQL forum.
Good Luck!
Joel Pérez

I want to translate some items but i cannot copy and paste into safari

i want to translate some items, but i cannot copy and paste from my clipboard into translator page using safari .
no, control-c just clunks a no-can-do warning

Thank you Carolyn, but I need to compare and contrast with Google, Microsoft and Babylon to sort out what is being said ... along with my own limited understanding of the language and topic ...
I have found that if I copy text it is in my clipboard with firefox, but I must paste from the firefox edit menu - not command v -
Unfortunately, I can find no workaround for Safari.
Thanks again Carolyn.

Can't Download PDF and ZIP Oracle Documentation

Hi!
I love you all at OTN. You are doing a great job,
enlightening us about Oracle technologies. Well done.
I experienced a problem while trying to download the
Oracle documentation files in pdf format. All the
download management software I tried to use kept
reporting that the server 'profile.oracle.com' reports
that the pdf files are text/html content type. And so
all the downloads where aborted. Only Internet
explorer can be used to download these pdf files and
IE is very slow and you can't resume the download if
the connection breaks.
Please kindly help me and others who may be
experiencing a similar problem.
Thanks and stay blessed
Olakunle Kolade

Hi !, you must try it with netscape, the best navigator of the world worldly...
Regards.

Error Message not in Oracle documentation

Hi
I am looking for the following error message in the Oracle documentation:
ORA-13365
It is not in the documentation that I have.
Thanks
Caroline
null

Caroline,
Here is the text for that error message.
It is missing from the Oracle documentation.
13365, 00000, "Layer SRID does not match geometry SRID"
// *Cause: Spatial layer has a geometry with a different SRID than the
// SRID specified for the layer.
// *Action: Make sure that all geometries in a layer have the same SRID and
// the SRIDs match the SRID in USER_SDO_GEOM_METADATA for the layer.
null

Oracle documentation DBMS_XMLSCHEMA.REGISTER_SCHEMA

Hi All,
I need an oracle documentation for the procedure DBMS_XMLSCHEMA.REGISTER_SCHEMA. Could you plz send me a good oracle / non-oracle link that would tell in details about what are the input and output parameters for this procedure and what it does.
Thanks in advance
-Aditi

See the following sections of the Oracle Doc
http://download-west.oracle.com/docs/cd/B19306_01/appdev.102/b14259/xdb03usg.htm#sthref267
http://download-west.oracle.com/docs/cd/B19306_01/appdev.102/b14259/xdb05sto.htm#sthref644
http://download-west.oracle.com/docs/cd/B19306_01/appdev.102/b14258/d_xmlsch.htm#i1008494

Local search in the Oracle Documentation

Dear Documentation Team,
As we know, the complete Oracle Documentation can be downloaded in HTML format and used locally. Unfortunately, it is not possible to search it locally in the comfortable way like it is done in the Internet version. Since all possible products like HTTP server etc. are available along with the Database, it would be very nice, if the documentation could be searched locally in the same way. I imagine something like that
1) put the complete documentation into the directory .\[name]
2) create index database for search
3) HTTP server must be running
4)
5) use URL http://the_host:5620/documentation/ to access and search the documentation
I think many people would appreciate this possibility.
Thanks for your attention

The 11g doc is still unable to provide us a local search.
Since we can download the HTML doc, we are able to build a doc webserver, and it could be practical for intranet usage to provide to the dev/dba team a full features doc.
Nicolas.

Where is the official Oracle documentation that describes Hot Backup?

I have used the woefully inadequate Metalink search utilities and Google but the nearest thing I have found is a description on "Ask Tom".
I am looking for the official Oracle documentation that describes what happens internally during a Hot Backup. There are a lot of web sites and blogs out there that describe it but I am looking for the description from Oracle themselves. The only things I have found in the Oracle documentation so far is how to start and stop Hot Backup but not what happens internally. Preferably 11gR2 if it makes any difference.
Thanks in advance.

Thanks mseberg. This is what I was looking for. I had read this manual before but apparently glossed over this paragraph:
"When performing a user-managed online backup, you must place your datafiles into
backup mode with the ALTER DATABASE or ALTER TABLESPACE statement with the
BEGIN BACKUP clause. When a tablespace is in backup mode, the database writes the
before image for an entire block to the redo stream before modifying a block. The
database also records changes to the block in the online redo log. Backup mode also
freezes the data file checkpoint until the file is removed from backup mode. Oracle
Database performs this safeguard because it cannot guarantee that a third-party
backup tool copies the file header before copying the data blocks."
Hot backup is still quite useful and Rman doesn't cover all cases. What we are doing with it is using storage-based replication (Shadow Image) to another set of LUNS which we then mount on another server and backup using Rman. This removes the overhead of Rman on the Production Database server and extends our backup window to almost 24 hours.

Translation of ORACLE hints to DB2 hints

Hi,
how can I translate the ORACLE hints to equivalent DB2 hints in the following SELECT statement:
====================================================================
    SELECT qmihqmnum qmihwarpl qmihwapos afihaufnr
      FROM qmih AS qmih
      INNER JOIN objk AS objk
        ON objkihnum = qmihqmnum
      INNER JOIN afih AS afih
        ON afihobknr = objkobknr
      INNER JOIN afko AS afko
        ON afkoaufnr = afihaufnr
      INNER JOIN afvc AS afvc
        ON afvcaufpl = afkoaufpl
        AND afvcaplzl = objkobzae
      INTO CORRESPONDING FIELDS OF TABLE lt_iwar
      WHERE afih~iphas = '2'
        AND afvc~phflg <> 'X'
        AND afko~gstrp <= lf_datum_eckstart
        AND qmih~warpl IN lr_warpln
        AND qmih~wapos IN lr_wapos
    %_HINTS
    ORACLE 'LEADING(T_00)'
    ORACLE 'USE_NL(T_00 T_01 T_02 T_03 T_04)'
    ORACLE 'INDEX(T_00 "QMIH~Z02")'
    ORACLE 'INDEX(T_01 "OBJK~M")'
    ORACLE 'INDEX(T_02 "AFIH~O")'
    ORACLE 'INDEX(T_03 "AFKO~0")'
    ORACLE 'INDEX(T_04 "AFVC~0")'.
====================================================================
Thanks a lot
Alex

Hello Hermann,
first of all thanks a lot for the quick reply.
In my example I'm referring to DB6.
I tested this statement without any hints resulting in a 4-5 times longer response time compared to the Oracle based system.
My biggest problem is, that the system uses index "C" to access table AFIH instead of using index "O" to join via field obknr.
Index "C" on table AFIH is defined as
-) MANDT
-) IPHAS
-) EQUNR
Index "O" is defined as
-) OBKNR
-) MANDT
Here's the EXPLAIN from ST05:
==========================================================================
   0 SELECT STATEMENT ( Estimated Costs = 1,962E+05 [timerons] ) num_rows tot_cost i/o_cost
          1 RETURN 6.3457E-02 1.9623E05 2.6207E04
              2 NLJOIN 6.3457E-02 1.9623E05 2.6207E04
                  3 [O] NLJOIN 3.9594E01 1.9563E05 2.6128E+04
                      4 [O] HSJOIN 1.5837E03 1.5969E05 2.1377E+04
                          5 [O] FETCH AFIH 4.8355E05 2.6256E04 3.4579E+03
                              6 IXSCAN AFIH~C #key columns: 2 4.8355E05 5.3460E02 8.3984E+01
                          7 <i> NLJOIN 5.9836E03 1.3342E05 1.7919E+04
                              8 [O] FETCH QMIH 5.7811E03 2.2441E03 5.7555E+02
                                  9 RIDSCN 5.7811E03 7.2107E01 8.0000E+00
                                     10 SORT 1.4452E03 1.8027E01 2.0000E+00
                                         11 IXSCAN QMIH~Z02 #key columns: 2 1.4452E03 1.7650E01 2.0000E+00
                                     12 SORT 1.4452E03 1.8027E01 2.0000E+00
                                         13 IXSCAN QMIH~Z02 #key columns: 2 1.4452E03 1.7650E01 2.0000E+00
                                     14 SORT 1.4452E03 1.8027E01 2.0000E+00
                                         15 IXSCAN QMIH~Z02 #key columns: 2 1.4452E03 1.7650E01 2.0000E+00
                                     16 SORT 1.4452E03 1.8027E01 2.0000E+00
                                         17 IXSCAN QMIH~Z02 #key columns: 2 1.4452E03 1.7650E01 2.0000E+00
                             18 <i> FETCH OBJK 1.0350E00 2.2700E01 3.0000E+00
                                 19 IXSCAN OBJK~M #key columns: 2 1.0350E00 1.5137E01 2.0000E+00
                     20 <i> FETCH AFKO 2.5000E-02 2.2700E01 3.0000E00
                         21 IXSCAN AFKO~0 #key columns: 2 1.0000E00 1.5136E01 2.0000E+00
                 22 <i> FETCH AFVC 1.6026E-03 1.5163E01 2.0032E00
                     23 IXSCAN AFVC~0 #key columns: 2 3.2053E-03 1.5139E01 2.0000E00
==========================================================================
So my question would be how to make the system use index "O" on table AFIH instead of using index "C".
Of course I studied note 868888. But still I don't know how to formulate hints for joins over more than two tables.
Maybe you can give me a how to do that.
Thanks a lot
Alex

Unexpected error occurred while translating metadata oracle.security.fed.xm

Getting Error while importing the SP metadata.
Caused by: javax.management.RuntimeMBeanException: Unexpected error occurred while translating metadata oracle.security.fed.xml.translator.TranslationException: org.xml.sax.SAXException: Could not locate translation scheme associated with "urn:oasis:names:tc:SAML:2.0:metadata":RequestedAttribute, child of "urn:oasis:names:tc:SAML:2.0:metadata":SPSSODescriptor.: {1}
Any Idea..Configuring OIF as IDP.
Thanks
Saurabh

Eevn i am facing same isssue.any clue

Translating some Oracle documentation

Similar Messages

Maybe you are looking for