[webkit-qt] A general rule for naming our files (and classes)
Zoltan Horvath
zoltan at webkit.org
Fri Oct 14 02:45:08 PDT 2011
Nice!
++
On Thu, 13 Oct 2011 19:35:34 +0200, Alexis Menard
<alexis.menard at openbossa.org> wrote:
> +1
>
> On Thu, Oct 13, 2011 at 12:24 PM, Tor Arne Vestbø
> <tor.arne.vestbo at nokia.com> wrote:
>> On 13.10.11 16:46, Kenneth Rohde Christiansen wrote:
>>>
>>> +1 from me
>>
>> +1!
>>
>>>
>>> On Thu, Oct 13, 2011 at 3:32 PM, Jesus Sanchez-Palencia
>>> <jesus at webkit.org> wrote:
>>>>>
>>>>> What about using the following guide to name our files?
>>>>
>>>> +1 for all that.
>>>> In addition, it's not naming related but following this
>>>> "let's-keep-things-aligned" wave I would also suggest that we keep
>>>> only
>>>> publicly exposed classes in UIProcess/API/qt. Everything else should
>>>> be
>>>> moved to UIProcess/qt as it was done already with qweberror (soon to
>>>> be
>>>> named QtWebError). I guess the remaining one there is qwebkittypes,
>>>> but
>>>> this
>>>> is another discussion.
>>>> Cheers
>>>> jesus
>>>>
>>>>>
>>>>> - Public API follow Qt conventions: qsomething.cpp qsomething.h and
>>>>> are
>>>>> named
>>>>> - Private classes for public API classes follow Qt conventions:
>>>>> qsomething_p.h qsomething_p.cpp (if needed)
>>>>> - Subclasses and Qt-specific implementations of WebKit/WebCore
>>>>> classes
>>>>> use Qt suffix: FrameLoaderClientQt.cpp
>>>>> - Other classes created for using in our port use Qt prefix:
>>>>> QtFileDownloader, QtViewInterface
>>>>>
>>>>> This is the best convention I could extract from existing practices.
>>>>> If we agree on this rule,
>>>>> I'll write it down in the http://trac.webkit.org/wiki/QtWebKitHacking
>>>>> page and the
>>>>> following files/classes would be renamed or have the file names
>>>>> adjusted:
>>>>>
>>>>> * UIProcess/qt:
>>>>>
>>>>> PolicyInterface -> QtPolicyInterface
>>>>> qdesktopwebpageproxy -> QtDesktopWebPageProxy
>>>>> qtouchwebpageproxy -> QtTouchWebPageProxy
>>>>> qweberror -> QtWebError
>>>>> SGTileNode -> QtSGTileNode
>>>>> SGUpdateQueue -> QtSGUpdateQueue
>>>>> TouchViewInterface -> QtTouchViewInterface
>>>>> ViewInterface -> QtViewInterface
>>>>> ViewportInteractionEngine -> QtViewportInteractionEngine
>>>>> WebUndoCommandQt -> QtWebUndoCommand
>>>>>
>>>>> qwk* files remain as is and will be renamed next time someone work
>>>>> with
>>>>> them.
>>>>>
>>>>>
>>>>> * WebProcess/WebCoreSupport/qt:
>>>>>
>>>>> WebFrameNetworkingContext -> WebFrameNetworkingContextQt
>>>>> (Web prefix here to differentiate from WK1 file)
>>>>>
>>>>>
>>>>> Cheers,
>>>>>
>>>>> --
>>>>> Caio Marcelo de Oliveira Filho
>>>>> OpenBossa - INdT
>>>>> _______________________________________________
>>>>> webkit-qt mailing list
>>>>> webkit-qt at lists.webkit.org
>>>>> http://lists.webkit.org/mailman/listinfo.cgi/webkit-qt
>>>>
>>>>
>>>> _______________________________________________
>>>> webkit-qt mailing list
>>>> webkit-qt at lists.webkit.org
>>>> http://lists.webkit.org/mailman/listinfo.cgi/webkit-qt
>>>>
>>>>
>>>
>>>
>>>
>>
>> _______________________________________________
>> webkit-qt mailing list
>> webkit-qt at lists.webkit.org
>> http://lists.webkit.org/mailman/listinfo.cgi/webkit-qt
>>
>
>
>
--
Using Opera's revolutionary email client: http://www.opera.com/mail/
More information about the webkit-qt
mailing list