Support intelephense docblock customization

[gjm]

Intelephense's docblock generator has some nice customization settings. Would be great to expose them in lsp-mode.

See this issue for details.

[yyoncho]

Here it is is how to do that

lsp-mode/lsp-intelephense.el

Line 153 in 843000b

'(("intelephense.trace.server" lsp-intelephense-trace-server)

if you want to provide a PR.

Also, you could set them without having a defcustom via:

(lsp-register-custom-settings
 '(("property.path" "property.value" t ))) ;; t means boolean property.

[gjm]

@yyoncho I'm not really fluent in elisp as to be able to provide a PR 😎

To manually set them should I do it before or after initializing lsp-mode? i.e. in :init or :config section in use-package?

[yyoncho]

I think that :config is the right place.

[gjm]

Can you please post an example of setting a json snippet? I want to set intelephense.phpdoc.functionTemplate to

{
    "summary": "$1",
    "tags": [
      "",
      "@param ${1:$SYMBOL_TYPE} $SYMBOL_NAME $2",
      "",
      "@return ${1:$SYMBOL_TYPE} $2",
      "@throws ${1:$SYMBOL_TYPE} $2"
    ]
}

Would be something like:

(lsp-register-custom-settings
 '(("intelephense.phpdoc.functionTemplate" "{....}")))

Thanks.

[yyoncho]

I'm not really fluent in elisp as to be able to provide a PR

It does not require elisp skills - you have several properties already defined - you just have to do the same for those who are not present.

Can you please post an example of setting a json snippet? I want to set intelephense.phpdoc.functionTemplate to

Use (list :prop1 "value-prop1" :prop2 "value-prop2") for objects and (vector "element1" "element2" ) for arrays.

[gjm]

To get what I described in the comment above I tried this:

(lsp-register-custom-settings
 '(("intelephense.phpdoc.functionTemplate"
    (list :summary "$1"
          :tags (vector ""
                        "@param ${1:$SYMBOL_TYPE} $SYMBOL_NAME $2"
                        ""
                        "@return ${1:$SYMBOL_TYPE} $2"
                        "@throws ${1:$SYMBOL_TYPE} $2""" "$1")))))

But this is what is sent to the server in the initialization string:

      ...
      "phpdoc": {
        "functionTemplate": [
          "list",
          "summary",
          "$1",
          "tags",
          [
            "vector",
            "",
            "@param ${1:$SYMBOL_TYPE} $SYMBOL_NAME $2",
            "",
            "@return ${1:$SYMBOL_TYPE} $2",
            "@throws ${1:$SYMBOL_TYPE} $2",
            "",
            "$1"
          ]
        ]
      }
      ...

It's all sent as arrays and not objects...

As I said earlier, I'm not skilled in elisp and I'm probably not writing it correctly. Can I get some help please?

[yyoncho]

Should be like that:

(lsp-register-custom-settings
 `(("intelephense.phpdoc.functionTemplate"
    ,(list :summary "$1"
          :tags (vector ""
                        "@param ${1:$SYMBOL_TYPE} $SYMBOL_NAME $2"
                        ""
                        "@return ${1:$SYMBOL_TYPE} $2"
                        "@throws ${1:$SYMBOL_TYPE} $2""" "$1")))))

[gjm]

As I said... I suck at elisp 😎
Thanks!

[gjm]

Just out of curiosity... whats the difference between ' and `?

[yyoncho]

https://www.gnu.org/software/emacs/manual/html_node/elisp/Quoting.html
https://www.gnu.org/software/emacs/manual/html_node/elisp/Backquote.html#Backquote

[charles-ritchie]

@gjm I am aware that inteliphense has this ability, but not how to trigger the auto completion. I imagine typing

/** 

should trigger the autocompletion, but this does not work for me.
How are you triggering the completion?

[gjm]

@charles-ritchie autocompletion triggers on /**C*/ where C is the cursor position. Works fine for me...

I'm assuming you know you have to buy a premium license for this to work...

[charles-ritchie]

@gjm hmmm still does not work for me. I have a premium license, so must be some form of configuration issue.

[gjm]

@charles-ritchie are you sure your premium license is active? I had some issues with it at first. If you M-x lsp-describe-session are all of the providers enabled in the Capabilities section?