Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 028d7cb3 authored by Nate Fischer's avatar Nate Fischer
Browse files

Docs: add a message to already-deprecated API 

No change to logic. This adds a deprecation message to
`getSaveFormData()`. The API was already deprecated in Android O, but it
looks like we forgot a message. This copies the message from
`setSaveFormData()`, with small wording tweaks.

This adds some other javadoc formatting changes, like adding `@see`
links between the getter/setter methods and linking to
`Build.VERSION_CODES.O`.

Fixes: 310672520
Test: make offline-sdk-docs
Flag: DOCS_ONLY
Change-Id: Ia1648cc8fbb1360bdd0deef22e0eb481a29310d7
parent c7c02412

core/java/android/webkit/WebSettings.java

+15 −8
Original line number Diff line number Diff line
@@ -497,25 +497,32 @@ public abstract class WebSettings { 
    public abstract  boolean getUseWebViewBackgroundForOverscrollBackground();



    /**

     * Sets whether the WebView should save form data. In Android O, the

     * platform has implemented a fully functional Autofill feature to store

     * form data. Therefore, the Webview form data save feature is disabled.

     * Sets whether the WebView should save form data. In {@link android.os.Build.VERSION_CODES#O},

     * the platform has implemented a fully functional Autofill feature to store form data.

     * Therefore, the Webview form data save feature is disabled.

     *

     * Note that the feature will continue to be supported on older versions of

     * <p>Note that the feature will continue to be supported on older versions of

     * Android as before.

     *

     * @deprecated In Android O and afterwards, this function does not have

     * any effect, the form data will be saved to platform's autofill service

     * if applicable.

     * @see #getSaveFormData

     * @deprecated In Android O and afterwards, this function does not have any effect. Form data

     * will be saved to platform's autofill service if applicable.

     */

    @Deprecated

    public abstract  void setSaveFormData(boolean save);



    /**

     * Gets whether the WebView saves form data.

     * Gets whether the WebView saves form data. In {@link android.os.Build.VERSION_CODES#O}, the

     * platform has implemented a fully functional Autofill feature to store form data. Therefore,

     * the Webview form data save feature is disabled.

     *

     * <p>Note that the feature will continue to be supported on older versions of

     * Android as before.

     *

     * @return whether the WebView saves form data

     * @see #setSaveFormData

     * @deprecated In Android O and afterwards, this function does not have any effect. Form data

     * will be filled from the platform's autofill service if applicable.

     */

    @Deprecated

    public abstract boolean getSaveFormData();